项目简介
"Nostr探索助手MCP服务器"是一个基于Model Context Protocol (MCP) 构建的后端服务,旨在为AI助手提供与Nostr去中心化社交网络进行交互的能力。通过这个服务器,AI助手可以实时获取Nostr上的对话、发布新的内容(如短消息、长文章)以及监控特定用户的通知。它将复杂的Nostr协议操作抽象为LLM易于理解和调用的工具与资源,极大地简化了AI应用集成Nostr的难度。
主要功能点
- 对话探索: AI助手可以根据关键词或标签搜索Nostr上的对话串,获取完整的对话上下文,并监控特定主题的活跃讨论。
- 内容发布: 支持发布类似Twitter的短笔记,包括添加话题标签、提及用户和回复;同时支持发布包含Markdown格式、摘要和头图的长篇文章。
- 通知管理: AI助手可以监控特定公共密钥被提及的情况,存储并检索这些通知,并能根据来源事件创建和发布通知。
- 实时资源订阅: 提供实时Nostr事件流订阅功能,AI助手可以订阅特定用户的事件,并按事件类型进行过滤,实现数据流的实时获取。
安装步骤
-
先决条件: 确保您的系统已安装 Node.js (18 或更高版本) 和 npm 或 yarn 包管理器。
-
克隆仓库:
git clone https://github.com/pablof7z/nostr-explore-mcp.git cd nostr-explore-mcp -
安装依赖:
npm install -
构建项目:
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列表。
信息
分类
通信与社交