Nostr MCP Server

Nostr MCP Server

site icon
2025.04.04 0
JavaScriptNostr 网络交互LLM 扩展交流协作
Nostr MCP Server 是一个模型上下文协议(MCP)服务器,为像 Claude 这样的 LLM 提供 Nostr 网络的能力。它实现了多种工具,用于与 Nostr 网络交互,包括获取用户信息、文本笔记、长文内容、zaps(打赏)记录以及搜索 Nostr 实现可能性(NIPs)。
View on GitHub

Overview

基本能力

产品定位

Nostr MCP Server 是一个为 LLM(如 Claude)提供 Nostr 网络交互能力的中间件服务器。

核心功能

  1. getProfile: 通过公钥获取用户信息
  2. getKind1Notes: 获取用户发布的文本笔记(kind 1)
  3. getLongFormNotes: 获取用户发布的长文内容(kind 30023)
  4. getReceivedZaps: 获取用户收到的 zaps,包括详细的支付信息
  5. getSentZaps: 获取用户发送的 zaps,包括详细的支付信息
  6. getAllZaps: 获取用户发送和接收的所有 zaps,并标注方向和总额
  7. searchNips: 搜索 Nostr 实现可能性(NIPs),并带有相关性评分

适用场景

  • 在 Claude 中查询 Nostr 用户信息
  • 获取 Nostr 用户的发布内容
  • 分析用户的打赏(zaps)记录
  • 搜索 Nostr 协议规范(NIPs)

工具列表

  1. getProfile: 获取 Nostr 用户的基本信息
  2. getKind1Notes: 获取用户发布的短文本内容
  3. getLongFormNotes: 获取用户发布的长文内容
  4. getReceivedZaps: 获取用户收到的打赏记录
  5. getSentZaps: 获取用户发送的打赏记录
  6. getAllZaps: 获取用户所有打赏记录(发送和接收)
  7. searchNips: 搜索 Nostr 协议规范

常见问题解答

  • 查询超时:尝试增加源代码中的 QUERY_TIMEOUT 值(当前为 8 秒)
  • 找不到数据:尝试指定不同的中继服务器
  • 详细错误信息:检查 Claude 的 MCP 日志

使用教程

使用依赖

  1. 安装 Node.js 环境
  2. 安装 Git

安装教程

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

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

  1. 修改配置后重启 Claude for Desktop 或 Cursor
  2. 检查日志中的错误信息
  3. 可以尝试增加查询超时时间或更换中继服务器

许可证

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