🌐 Nostr Mcp 服务器

什么是 Nostr MCP？

Nostr MCP 是一个旨在促进与 Nostr 协议交互的服务器。它使用户能够有效地发布笔记、管理内容并参与 Nostr 生态系统。该服务器充当桥梁，允许在 Nostr 框架内实现无缝通信和数据交换，使其成为对去中心化通信感兴趣的开发者和用户的重要工具。

Nostr MCP 的特点

• 用户友好的界面：Nostr MCP 提供直观的界面，简化了发布笔记和管理交互的过程。
• 去中心化通信：基于去中心化原则构建，确保用户对其数据和交互拥有控制权。
• 实时更新：该服务器支持实时更新，允许用户即时接收有关其帖子和交互的通知。
• 开源：Nostr MCP 是开源的，这意味着任何人都可以为其开发做出贡献，确保持续改进和创新。
• 多平台支持：它被设计为能够在各种平台上工作，使更广泛的受众能够访问。

如何使用 Nostr MCP

1. 安装：首先从 GitHub 克隆 Nostr MCP 仓库。按照仓库 README 文件中提供的安装说明进行操作。
2. 配置：根据您的需求配置服务器设置。这可能包括设置用户帐户、权限和其他偏好设置。
3. 发布笔记：设置完成后，用户可以通过界面直接开始发布笔记。该过程简单易用。
4. 与社区互动：利用服务器与其他用户互动，分享见解，并参与与 Nostr 相关的讨论。
5. 贡献：作为一个开源项目，欢迎贡献。用户可以报告问题、建议功能，或甚至提交代码以增强服务器的功能。

常见问题解答

问：Nostr MCP 的目的是什么？

答：Nostr MCP 作为与 Nostr 协议交互的服务器，使用户能够发布笔记并参与去中心化通信。

问：Nostr MCP 是免费使用的吗？

答：是的，Nostr MCP 是一个开源项目，使用和修改都是免费的。

问：我如何能为 Nostr MCP 贡献？

答：您可以通过报告问题、建议功能或通过 GitHub 仓库提交代码改进来贡献。

问：Nostr MCP 支持哪些平台？

答：Nostr MCP 被设计为与多个平台兼容，确保广泛用户的可访问性。

问：我在哪里可以找到 Nostr MCP 的文档？

答：文档通常可以在仓库的 README 文件中找到，或在项目的 GitHub 页面上的专门文档部分中找到。

🌐 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:

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": "user@domain.com",
  "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

• Join Nostr
• Nostr Manifesto
• Nostr Specifications
• Model Context Protocol
• Visual testing tool for MCP servers
• Awesome MCP Servers
• Awesome MCP Clients
• MCP TypeScript SDK
• Nostr Development Kit (NDK)

📬 Contact

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

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

Or just scan this QR code to find me:

<p align="center"> Made with ❤️ for the Nostr community </p>