🚀 Empowering AI with Free Speech: The Nostr MCP Server

Harness the power of the Model Context Protocol (MCP) to connect your AI models to the decentralized world of Nostr. This server enables AI agents to post notes, interact with users, and leverage the censorship-resistant nature of Nostr for truly autonomous communication.

Why Nostr for AI? In an era of increasing content moderation, Nostr provides a vital platform for uncensored communication. By integrating your AI with Nostr, you ensure its voice remains independent and resilient.

✨ Key Capabilities

Nostr Note Publication: Seamlessly post content to the Nostr network, enabling AI-driven content creation and dissemination.
Multi-Relay Connectivity: Connect to a diverse range of Nostr relays, maximizing reach and redundancy.
MCP Compliance: Adheres to the Model Context Protocol, ensuring interoperability with a wide ecosystem of AI tools and platforms.
Lightning Zaps (In Progress): Future support for sending Lightning Network payments (zaps) to Nostr users, enabling AI-driven micro-transactions and content monetization.
Real-time Communication with SSE: Leverage Server-Sent Events (SSE) for efficient, real-time data streaming and interaction.

🛠️ Installation and Setup

Prerequisites

Node.js 18+

Installation Steps

Clone the Repository:

git clone https://github.com/AbdelStark/nostr-mcp
cd nostr-mcp

Install Dependencies:
```
npm install
```
Configure Environment Variables:
- Create a .env file (copy from .env.example for a template).
- LOG_LEVEL: Set the desired logging level (debug, info, warn, error).
- NODE_ENV: Specify the environment (development, production).
- NOSTR_RELAYS: A comma-separated list of Nostr relay URLs (e.g., wss://relay.damus.io,wss://relay.primal.net).
- NOSTR_NSEC_KEY: Your Nostr private key (starting with nsec). Important: Handle this key with extreme care.
- SERVER_MODE: Choose the server mode (stdio or sse).
- PORT: The port for SSE mode (e.g., 9000).
```
LOG_LEVEL=debug
NODE_ENV=development
NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
NOSTR_NSEC_KEY=your_nsec_key_here
SERVER_MODE=sse
PORT=9000
```

Running the Server

# Development mode with hot reload
npm run dev

# Production mode
npm start

⚙️ Available Tools

The Nostr MCP Server exposes the following tools for AI interaction:

post_note: Publishes a new note to the Nostr network.

{
  "content": "Hello from my AI agent on Nostr! 👋"
}

send_zap (Work in Progress): Sends a Lightning zap to a Nostr user.

{
  "nip05Address": "[email protected]",
  "amount": 1000
}

🧩 Project Structure

nostr-mcp/
├── src/
│   ├── index.ts        # Main server entry point
│   ├── nostr-client.ts # Nostr client implementation
│   └── types.ts        # TypeScript type definitions
├── .env               # Environment configuration
└── tsconfig.json     # TypeScript configuration

🧪 Testing

npm test

🤝 Contributing

We welcome contributions to enhance the Nostr MCP Server!

Fork the repository.
Create a feature branch (git checkout -b feature/my-new-feature).
Commit your changes (git commit -m 'Add cool feature').
Push to the branch (git push origin feature/my-new-feature).
Submit a pull request.

🔗 Resources

✉️ Contact

Feel free to connect with me on Nostr:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Nostr Public Key QR Code

Built with ❤️ for a decentralized future.

nostr-mcp