Nostr MCP Server

1# 🌐 Nostr MCP Server
2 
3A 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.
4 
5Censorship resistance matters, even for LLMs.
6 
7[![smithery badge](https://smithery.ai/badge/@AbdelStark/nostr-mcp)](https://smithery.ai/server/@AbdelStark/nostr-mcp)
8[![TypeScript](https://img.shields.io/badge/TypeScript-007ACC?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
9[![MCP](https://img.shields.io/badge/MCP-Protocol-blue?style=flat-square)](https://github.com/modelcontextprotocol/typescript-sdk)
10[![Nostr](https://img.shields.io/badge/Nostr-Protocol-purple?style=flat-square)](https://nostr.com/)
11 
12BTW, you should [join Nostr now!](https://start.njump.me/?s=npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29)
13 
14## 🚀 Features
15 
16- 📝 Post notes to Nostr network
17- 🔌 Connect to multiple relays
18- 🤖 MCP-compliant API for AI integration
19- 💸 Send Lightning zaps to Nostr users (WIP)
20- 📡 Server-Sent Events (SSE) support for real-time communication
21 
22## 👷‍♂️ TODOs
23 
24- [ ] Add support for multiple simultaneous connections
25- [ ] Implement stdin transport mode (configurable via environment variable)
26 
27## 📋 Prerequisites
28 
29- Node.js 18+
30 
31## 🛠️ Installation
32 
33### Installing via Smithery
34 
35To install Nostr MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@AbdelStark/nostr-mcp):
36 
37```bash
38npx -y @smithery/cli install @AbdelStark/nostr-mcp --client claude
39```
40 
41### Manual Installation
421. Clone the repository:
43 
44```bash
45git clone https://github.com/AbdelStark/nostr-mcp
46cd nostr-mcp
47```
48 
491. Install dependencies:
50 
51```bash
52npm install
53```
54 
551. Create a `.env` file:
56 
57> 💡 You can copy the `.env.example` file and modify it as needed.
58 
59```env
60# Log level (debug, info, warn, error)
61LOG_LEVEL=debug
62# Node environment (development, production)
63NODE_ENV=development
64# List of Nostr relays to connect to
65NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
66# Your Nostr private key (starts with nsec)
67NOSTR_NSEC_KEY=your_nsec_key_here
68# Server mode (stdio or sse)
69SERVER_MODE=sse
70# Port for SSE mode
71PORT=9000
72```
73 
74## 🚦 Usage
75 
76### Starting the Server
77 
78```bash
79# Development mode with hot reload
80npm run dev
81 
82# Production mode
83npm start
84```
85 
86### Available Tools
87 
88#### `post_note`
89 
90Posts a new note to the Nostr network.
91 
92Example input:
93 
94```json
95{
96  "content": "Hello from Nostr! 👋"
97}
98```
99 
100#### `send_zap`
101 
102Sends a Lightning zap to a Nostr user.
103 
104Example input:
105 
106```json
107{
108  "nip05Address": "user@domain.com",
109  "amount": 1000
110}
111```
112 
113## 🔧 Development
114 
115### Project Structure
116 
117```text
118nostr-mcp/
119├── src/
120│   ├── index.ts        # Main server entry point
121│   ├── nostr-client.ts # Nostr client implementation
122│   └── types.ts        # TypeScript type definitions
123├── .env               # Environment configuration
124└── tsconfig.json     # TypeScript configuration
125```
126 
127### Running Tests
128 
129```bash
130npm test
131```
132 
133## 🤝 Contributing
134 
1351. Fork the repository
1362. Create your feature branch (`git checkout -b feature/amazing-feature`)
1373. Commit your changes (`git commit -m 'Add some amazing feature'`)
1384. Push to the branch (`git push origin feature/amazing-feature`)
1395. Open a Pull Request
140 
141## 📜 License
142 
143This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
144 
145## 🔗 Resources
146 
147- [Join Nostr](https://start.njump.me/?s=npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29)
148- [Nostr Manifesto](https://fiatjaf.com/nostr.html)
149- [Nostr Specifications](https://github.com/nostr-protocol/nips)
150- [Model Context Protocol](https://modelcontextprotocol.io/introduction)
151- [Visual testing tool for MCP servers](https://github.com/modelcontextprotocol/inspector)
152- [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)
153- [Awesome MCP Clients](https://github.com/punkpeye/awesome-mcp-clients)
154- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
155- [Nostr Development Kit (NDK)](https://github.com/nostr-dev-kit/ndk)
156 
157## 📬 Contact
158 
159Feel free to follow me if you'd like, using my public key:
160 
161```text
162npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29
163```
164 
165Or just **scan this QR code** to find me:
166 
167![Nostr Public Key QR Code](https://hackmd.io/_uploads/SkAvwlYYC.png)
168 
169---
170 
171<p align="center">
172  Made with ❤️ for the Nostr community
173</p>
174