返回 MCP 目录
public公开dns本地运行

Nostr

一个基于Model Context Protocol (MCP)的服务端,使AI模型能够与Nostr网络交互,实现去中心化社交功能。

article

README

🚀 🌐 Nostr MCP 服务器

Nostr MCP 服务器是一个支持 AI 模型与 Nostr 网络交互的 Model Context Protocol (MCP) 服务器。它允许 AI 模型发布笔记,并与自由发言协议进行互动。在当今环境下,即便对于 LLM(大型语言模型)而言,抵制审查制度也具有重要意义。

smithery 徽章 TypeScript MCP Nostr

顺便提一句,你应该现在就 加入 Nostr 网络!

🚀 快速开始

安装

使用 Smithery 安装

通过 Smithery 可自动安装 Nostr MCP Server for Claude Desktop:

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

手动安装

  1. 克隆仓库:
git clone https://github.com/AbdelStark/nostr-mcp
cd nostr-mcp
  1. 安装依赖项:
npm install
  1. 创建一个 .env 文件:

💡 你可以复制 .env.example 文件并按需修改。

# 日志级别(debug, info, warn, error)
LOG_LEVEL=debug
# 环境(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=stdio

启动

安装完成后,运行以下命令启动服务器:

npm run dev

默认情况下,服务器将在 ws://localhost:3001http://localhost:3000 上运行。

✨ 主要特性

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

👷‍♂️ 待办事项

  • [ ] 添加对多个同时连接的支持
  • [ ] 实现标准输入传输模式(可通过环境变量配置)

📦 安装指南

使用 Smithery 安装

通过 Smithery 自动安装 Nostr MCP Server for Claude Desktop:

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

手动安装

  1. 克隆仓库:
git clone https://github.com/AbdelStark/nostr-mcp
cd nostr-mcp
  1. 安装依赖项:
npm install
  1. 创建一个 .env 文件:

💡 你可以复制 .env.example 文件并按需修改。

# 日志级别(debug, info, warn, error)
LOG_LEVEL=debug
# 环境(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=stdio

📚 详细文档

依赖项

  • Node.js 18+

注意事项

  • 确保你已经安装了 Node.js 18+
  • 如果你需要在生产环境中使用,建议配置适当的防火墙和安全措施
  • 可以通过修改 .env 文件来调整服务器行为

为 Nostr 社区用心打造


help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端