mcpField
🌐
🌐 Nostr MCP Server

🌐 Nostr MCP Server

Local
github.com/AbdelStarkSocial Media39Updated 90w ago
Repository

About 🌐 Nostr MCP Server

Nostr MCP Server is an MCP server that lets AI models interact with the Nostr network, such as posting notes. It suits developers who want LLMs to connect to a decentralized social protocol, and it can connect to multiple relays.

Key features

  1. 01Post notes to the Nostr network
  2. 02Connect to multiple relays
  3. 03MCP-compliant API
  4. 04Server-Sent Events support for real-time communication
  5. 05Lightning zap sending (work in progress)

Use cases

  1. 01Letting an AI model publish Nostr notes
  2. 02Connecting Nostr to MCP clients such as Claude Desktop
  3. 03Testing LLM integration with a decentralized social network

MCP support

This project is an MCP server that exposes the post_note and send_zap tools to MCP clients, with send_zap still in progress.

#nostr#llm#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json Β· Universal config
{
  "mcpServers": {
    "nostr": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
Run commandnpx -y @smithery/cli

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@smithery/cli

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

🌐 Nostr MCP Server

A Model Context Protocol (MCP) server that enables AI models to interact with Nostr, allowing them to post notes and interact with the freedom of speech protocol.

Censorship resistance matters, even for LLMs.

smithery badge TypeScript MCP Nostr

BTW, you should join Nostr now!

πŸš€ Features

  • πŸ“ Post notes to Nostr network
  • πŸ”Œ Connect to multiple relays
  • πŸ€– MCP-compliant API for AI integration
  • πŸ’Έ Send Lightning zaps to Nostr users (WIP)
  • πŸ“‘ Server-Sent Events (SSE) support for real-time communication

πŸ‘·β€β™‚οΈ TODOs

  • Add support for multiple simultaneous connections
  • Implement stdin transport mode (configurable via environment variable)

πŸ“‹ Prerequisites

  • Node.js 18+

πŸ› οΈ Installation

Installing via Smithery

To install Nostr MCP Server for Claude Desktop automatically via Smithery:

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
  1. Install dependencies:
npm install
  1. Create a .env file:

πŸ’‘ You can copy the .env.example file and modify it as needed.

# Log level (debug, info, warn, error)
LOG_LEVEL=debug
# Node environment (development, production)
NODE_ENV=development
# List of Nostr relays to connect to
NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
# Your Nostr private key (starts with nsec)
NOSTR_NSEC_KEY=your_nsec_key_here
# Server mode (stdio or sse)
SERVER_MODE=sse
# Port for SSE mode
PORT=9000

🚦 Usage

Starting the Server
# Development mode with hot reload
npm run dev

# Production mode
npm start
Available Tools
post_note

Posts a new note to the Nostr network.

Example input:

{
  "content": "Hello from Nostr! πŸ‘‹"
}
send_zap

Sends a Lightning zap to a Nostr user.

Example input:

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

πŸ”§ Development

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
Running Tests
npm test

🀝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

πŸ“œ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ”— Resources

πŸ“¬ Contact

Feel free to follow me if you'd like, using my public key:

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or just scan this QR code to find me:

Nostr Public Key QR Code

Made with ❀️ for the Nostr community

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.