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.
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:
Manual Installation
- Clone the repository:
- Install dependencies:
- Create a
.envfile:
You can copy the.env.examplefile and modify it as needed.
Usage
Starting the Server
Available Tools
`post_note`
Posts a new note to the Nostr network.
Example input:
`send_zap`
Sends a Lightning zap to a Nostr user.
Example input:
Development
Project Structure
Running Tests
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- 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:
Or just scan this QR code to find me:
Nostr Public Key QR Code
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.
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:
Manual Installation
- Clone the repository:
- Install dependencies:
- Create a
.envfile:
You can copy the.env.examplefile and modify it as needed.
Usage
Starting the Server
Available Tools
`post_note`
Posts a new note to the Nostr network.
Example input:
`send_zap`
Sends a Lightning zap to a Nostr user.
Example input:
Development
Project Structure
Running Tests
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature)
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to the branch (
git push origin feature/amazing-feature)
- 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:
Or just scan this QR code to find me:
Nostr Public Key QR Code