Nostr MCP Server

基本能力

产品定位

Nostr MCP Server 是一个为大型语言模型（如 Claude）提供 Nostr 网络交互能力的中间件服务器。它使得这些模型能够查询和操作 Nostr 网络中的数据，如用户信息、文本笔记、长文内容和支付记录等。

核心功能

1. 用户信息查询：通过 getProfile 工具获取用户的公开信息。
2. 文本笔记查询：通过 getKind1Notes 工具获取用户发布的文本笔记。
3. 长文内容查询：通过 getLongFormNotes 工具获取用户发布的长文内容。
4. 支付记录查询：
5. getReceivedZaps：获取用户接收的支付记录。
6. getSentZaps：获取用户发送的支付记录。
7. getAllZaps：获取用户的所有支付记录（发送和接收）。
8. NIPs 搜索：通过 searchNips 工具搜索 Nostr 实现可能性（NIPs）。

适用场景

1. 用户信息查询：快速获取 Nostr 网络中用户的公开信息。
2. 内容浏览：查看用户发布的文本笔记和长文内容。
3. 支付记录管理：跟踪用户的支付记录（发送和接收）。
4. NIPs 搜索：查找与特定主题相关的 Nostr 实现可能性。

工具列表

1. getProfile：获取用户的公开信息。
2. getKind1Notes：获取用户发布的文本笔记。
3. getLongFormNotes：获取用户发布的长文内容。
4. getReceivedZaps：获取用户接收的支付记录。
5. getSentZaps：获取用户发送的支付记录。
6. getAllZaps：获取用户的所有支付记录（发送和接收）。
7. searchNips：搜索 Nostr 实现可能性（NIPs）。

常见问题解答

1. 查询超时：可以尝试增加 QUERY_TIMEOUT 的值（默认为 8 秒）。
2. 无数据返回：尝试指定不同的中继服务器。
3. 错误排查：检查 Claude 的 MCP 日志以获取详细的错误信息。

使用教程

使用依赖

确保已安装 Node.js 和 npm。

安装教程

# 克隆仓库
git clone https://github.com/austinkelsay/nostr-mcp-server.git
cd nostr-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

1. 配置 Claude for Desktop：
2. 编辑配置文件（macOS）： bash vim ~/Library/Application\ Support/Claude/claude_desktop_config.json
3. 添加 Nostr 服务器配置： json { "mcpServers": { "nostr": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/nostr-mcp-server/build/index.js" ] } } }
4. 替换 /ABSOLUTE/PATH/TO/ 为实际路径。

5. 重启 Claude for Desktop。

6. 配置 Cursor：

7. 编辑配置文件（macOS）： bash vim ~/.cursor/config.json
8. 添加 Nostr 服务器配置： json { "mcpServers": { "nostr": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/nostr-mcp-server/build/index.js" ] } } }
9. 替换 /ABSOLUTE/PATH/TO/ 为实际路径。
10. 重启 Cursor。

基本调试步骤

1. 查询用户信息： bash "Show me the profile information for npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
2. 查询文本笔记： bash "What are the recent posts from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8?"
3. 查询长文内容： bash "Show me the long-form articles from npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8"
4. 查询支付记录： bash "How many zaps has npub1qny3tkh0acurzla8x3zy4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 received?"
5. 搜索 NIPs： bash "Search for NIPs about zaps"

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。