Nostr MCP Server: Enabling Secure AI Interactions on Nostr

Overview: What is Nostr MCP Server?

Nostr MCP Server is an advanced infrastructure that acts as a bridge between artificial intelligence (AI) applications and the decentralized Nostr protocol, ensuring secure and censorship-resistant interactions. Built using modern web technologies, this server supports AI model contexts through the Model Context Protocol (MCP), allowing developers to integrate their applications seamlessly with the freedom of speech Nostr network.

🔧 Core Features & MCP Capabilities

Nostr MCP Server boasts a robust set of features specifically designed for seamless integration and real-time interactions. Key capabilities include:

Data Interaction

• Post Notes: Users can post notes directly from AI models to the Nostr network with ease.
• Connect to Multiple Relays: The server supports connecting to multiple relays, ensuring connectivity even under network disruptions.

Advanced AI Support

• MCP Compliance: MCP-compliant API that allows AI applications like Claude Desktop, Continue, and Cursor to interact efficiently with the Nostr protocol.
• Lightning Zap Integration (WIP): Future-proofing the server by incorporating upcoming Payment Protocol support for sending Lightning zaps.

Real-Time Communication

• Server-Sent Events (SSE) Support: Provides real-time communication between AI models and Nostr nodes, enhancing interactivity and responsiveness.

⚙️ MCP Architecture & Protocol Implementation

The architecture of Nostr MCP Server is built around a modular design to support various components and ensure scalability. The server consists of the following main parts:

Components Breakdown

• Main Entry Point: src/index.ts - This file serves as the primary point of execution, initiating the server process.
• Nostr Client Implementation: src/nostr-client.ts - Handles communication with Nostr relays and ensures data integrity through MCP protocol standards.
• Type Definitions: src/types.ts - Provides TypeScript type definitions for better code quality and maintainability.

Protocol Flow Diagram

graph TD
    A[AI Application] -->|MCP Client| B[MCP Protocol]
    B --> C[MCP Server]
    C --> D[Nostr Network]
    style A fill:#e1f5fe
    style C fill:#f3e5f5
    style D fill:#e8f5e8

MCP Client Compatibility Matrix

MCP Client	Resources	Tools	Prompts	Status
Claude Desktop	✅	✅	✅	Full Support
Continue	✅	✅	✅	Full Support
Cursor	❌ (Tools Only)	✅	❌	Tools Only

🚀 Getting Started with Installation

Installing Nostr MCP Server is straightforward and can be done via a Smithery automated setup or manually.

Installing via Smithery

To install Nostr MCP Server for Claude Desktop automatically:

npx -y @smithery/cli install @AbdelStark/nostr-mcp --client claude

Manual Installation

1. Clone the Repository

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

2. Install Dependencies

   npm install
   

3. Create a .env File

   • Copy and modify the following configuration:

   LOG_LEVEL=debug
   NODE_ENV=development
   NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
   NODE_NSEC_KEY=your_nsec_key_here
   SERVER_MODE=sse
   PORT=9000
   

💡 Key Use Cases in AI Workflows

Real-Time Note Posting for AI Research

• Scenario: A researcher deploys an MCP-compliant model that needs to post experimental results instantaneously. The Nostr MCP Server ensures reliable delivery of these notes, enhancing collaboration and transparency.

Interactive Prompt-Based Q&A Systems

• Scenario: An AI chatbot interacts in real-time with users, leveraging the Nostr protocol for private and secure conversations. This setup guarantees that user data is handled according to privacy standards while maintaining the conversational flow.

🔌 Integration with MCP Clients

Nostr MCP Server is fully compatible with various MCP clients, including Claude Desktop, Continue, and Cursor, ensuring seamless integration across different AI applications. Users can easily configure their clients to work with this server by following the setup instructions provided in the README.

MCP Configuration Sample

{
  "mcpServers": {
    "nostr-mcp-server": {
      "command": "npx",
      "args": ["-y", "@AbdelStark/nostr-mcp"],
      "env": {
        "NOSTR_RELAY": "wss://relay.damus.io",
        "NOSTR_NSEC_KEY": "your_nsec_key_here"
      }
    }
  }
}

📊 Performance & Compatibility Matrix

While Nostr MCP Server is designed to be highly compatible with various clients, some tools may require additional setup steps. The following matrix provides an overview of compatibility:

Tool	Integration Level
Claude Desktop	✅
Continue	✅
Cursor	❌

🛠️ Advanced Configuration & Security

Environment Variables

• LOG_LEVEL: Set the logging level to control how much information is output. Options include debug, info, warn, and error.
• NODE_ENV: Specify whether the environment is development or production.
• NOSTR_RELAYS: List of Nostr relay URLs for connecting.
• NOSTR_NSEC_KEY: Your personal Nostr private key (starts with nsec).
• SERVER_MODE: Define the server mode as stdio or sse.

Example .env File

LOG_LEVEL=debug
NODE_ENV=development
NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
NOSTR_NSEC_KEY=nsec1abcdef01234567890123
SERVER_MODE=sse
PORT=9000

❓ Frequently Asked Questions (FAQ)

Q: How does Nostr MCP Server ensure censorship resistance?

• A: By utilizing the decentralized nature of the Nostr protocol, data is posted through a network of relays, making it difficult for any single entity to block or manipulate content.

Q: Can I integrate Non-MCP compliant clients with this server?

• A: While the primary focus is on MCP compliance, efforts are being made to support non-compliant clients via workarounds and custom scripts. Contact us if you face challenges.

Q: How does Nostr MCP Server handle Lightning zaps?

• A: Although currently still in development, future versions will include support for sending Lightning zaps using Payment Protocol interfaces.

Q: Can I use this server with multiple AI models?

• A: Yes, by configuring the MCP clients to connect to different servers or setting up multiple instances of Nostr MCP Server. Each instance can handle a unique set of clients.

Q: Is Nostr MCP Server scalable for large-scale applications?

• A: The modular design and support for multiple relays make it suitable for both small and large-scale deployments, ensuring high availability and performance under load.

👨‍💻 Development & Contribution Guidelines

1. Fork the Repository
2. Create a Feature Branch
3. Make Changes & Commit
4. Push to Your Repo
5. Open a Pull Request

🌐 MCP Ecosystem & Resources

• Join Nostr
• Nostr Manifesto
• Nostr Specifications
• Model Context Protocol Introduction
• Visual Testing Tool for MCP Servers

📬 Contact

Follow the development of Nostr MCP Server and join discussions at:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Nostr is excited to support the decentralized AI landscape and encourage contributions from the community.

---

This comprehensive documentation positions Nostr MCP Server as a critical component for developers aiming to build secure, censorship-resistant AI applications on the Nostr protocol. By emphasizing its features, architecture, and use cases, it ensures that users understand the value proposition and can confidently integrate this server into their projects.