🌐 Nostr MCP 服务器

一个模型上下文协议 (MCP) 服务器，使 AI 模型能够与 Nostr 交互，允许它们发布笔记并以言论自由协议进行互动。

审查抵抗很重要，即使对于 LLM 也是如此。

顺便说一句，你应该立即加入 Nostr！

🚀 功能

• 📝 向 Nostr 网络发布笔记
• 🔌 连接到多个中继
• 🤖 用于 AI 集成的 MCP 兼容 API
• 💸 向 Nostr 用户发送 Lightning zaps (WIP)
• 📡 用于实时通信的服务器发送事件 (SSE) 支持

👷‍♂️ TODOs

• [ ] 添加对多个并发连接的支持
• [ ] 实现 stdin 传输模式（可通过环境变量配置）

📋 前提条件

• Node.js 18+

🛠️ 安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Nostr MCP Server：

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

手动安装

1. 克隆存储库：

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

2. 安装依赖项：

npm install

3. 创建一个 .env 文件：

💡 您可以复制 .env.example 文件并根据需要进行修改。

# 日志级别（debug、info、warn、error）
LOG_LEVEL=debug
# Node 环境（development、production）
NODE_ENV=development
# 要连接的 Nostr 中继列表
NOSTR_RELAYS=wss://relay.damus.io,wss://relay.primal.net,wss://nos.lol
# 您的 Nostr 私钥（以 nsec 开头）
NOSTR_NSEC_KEY=your_nsec_key_here
# 服务器模式（stdio 或 sse）
SERVER_MODE=sse
# SSE 模式的端口
PORT=9000

🚦 用法

启动服务器

# 具有热重载的开发模式
npm run dev

# 生产模式
npm start

可用工具

post_note

向 Nostr 网络发布新笔记。

示例输入：

{
  "content": "来自 Nostr 的问候！ 👋"
}

send_zap

向 Nostr 用户发送 Lightning zap。

示例输入：

{
  "nip05Address": "user@domain.com",
  "amount": 1000
}

🔧 开发

项目结构

nostr-mcp/
├── src/
│   ├── index.ts        # 主服务器入口点
│   ├── nostr-client.ts # Nostr 客户端实现
│   └── types.ts        # TypeScript 类型定义
├── .env               # 环境配置
└── tsconfig.json     # TypeScript 配置

运行测试

npm test

🤝 贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📜 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🔗 资源

• 加入 Nostr
• Nostr 宣言
• Nostr 规范
• 模型上下文协议
• MCP 服务器的可视化测试工具
• Awesome MCP Servers
• Awesome MCP Clients
• MCP TypeScript SDK
• Nostr 开发工具包 (NDK)

📬 联系

如果您愿意，请随意关注我，使用我的公钥：

npub1hr6v96g0phtxwys4x0tm3khawuuykz6s28uzwtj5j0zc7lunu99snw2e29

或者只是扫描此 QR 码来找到我：

---

<p align="center"> 用 ❤️ 为 Nostr 社区制作 </p>