项目简介

"Nostr探索助手MCP服务器"是一个基于Model Context Protocol (MCP) 构建的后端服务,旨在为AI助手提供与Nostr去中心化社交网络进行交互的能力。通过这个服务器,AI助手可以实时获取Nostr上的对话、发布新的内容(如短消息、长文章)以及监控特定用户的通知。它将复杂的Nostr协议操作抽象为LLM易于理解和调用的工具与资源,极大地简化了AI应用集成Nostr的难度。

主要功能点

  • 对话探索: AI助手可以根据关键词或标签搜索Nostr上的对话串,获取完整的对话上下文,并监控特定主题的活跃讨论。
  • 内容发布: 支持发布类似Twitter的短笔记,包括添加话题标签、提及用户和回复;同时支持发布包含Markdown格式、摘要和头图的长篇文章。
  • 通知管理: AI助手可以监控特定公共密钥被提及的情况,存储并检索这些通知,并能根据来源事件创建和发布通知。
  • 实时资源订阅: 提供实时Nostr事件流订阅功能,AI助手可以订阅特定用户的事件,并按事件类型进行过滤,实现数据流的实时获取。

安装步骤

  1. 先决条件: 确保您的系统已安装 Node.js (18 或更高版本) 和 npm 或 yarn 包管理器。

  2. 克隆仓库:

    git clone https://github.com/pablof7z/nostr-explore-mcp.git
    cd nostr-explore-mcp
  3. 安装依赖:

    npm install
  4. 构建项目:

    npm run build

服务器配置 (用于MCP客户端)

为了让您的MCP客户端(例如:Claude Desktop)能够连接并使用这个Nostr MCP服务器,您需要在客户端的配置文件中添加以下JSON片段。这将告知客户端如何启动和连接到服务器。

{
  "mcpServers": {
    "nostr-explore": {
      "command": "node",
      "args": ["path/to/dist/index.js"],
      "comment": "指定node命令启动服务器,参数为dist目录下编译好的主文件路径"
    }
  }
}
  • 'nostr-explore': 这是您在MCP客户端中为该服务器定义的唯一名称。
  • 'command': 启动服务器所使用的命令,此处为 'node'。
  • 'args': 启动命令的参数,'["path/to/dist/index.js"]' 应替换为您实际构建后服务器代码的入口文件路径。
  • 'comment': (可选) 配置的说明,帮助您理解其作用。

基本使用方法

配置完成后,您的AI助手将能够通过MCP客户端与此服务器交互,并调用其提供的工具和资源。

  • 发布短笔记 (例如通过AI助手调用): AI助手可以调用名为 'nostr_publish_note' 的工具。

    • 如果您已设置 'NOSTR_PRIVATE_KEY' 环境变量,只需提供内容、话题标签和提及的用户。
    • 或者,您也可以直接在调用时提供 'nsec' 参数。
  • 搜索对话 (例如通过AI助手调用): AI助手可以调用名为 'nostr_conversation_tracker' 的工具。

    • 提供一个 'query' 参数,包含关键词或话题标签,如 '"#bitcoin"'。
    • 可选地指定 'limit' (结果数量) 和 'thread_depth' (回复深度)。
  • 订阅实时事件流 (例如通过AI助手调用): AI助手可以通过 URI 'nostr://feed/{pubkey-or-npub}/{kinds}?relays=wss://relay1.com,wss://relay2.com' 订阅特定用户的实时事件流。

    • '{pubkey-or-npub}': 要订阅的Nostr用户公钥。
    • '{kinds}': (可选) 逗号分隔的事件类型,如 '1,30023'。
    • '?relays=...': (可选) 逗号分隔的中继器URL列表。

信息

分类

通信与社交