Austinkelsay Nostr MCP Server

🚀 無殼 Nostr MCP 服務器

無殼 Nostr MCP 服務器是一個為像 Claude 這樣的大型語言模型（LLM）提供 Nostr 功能的 Model Context Protocol (MCP) 服務器，能助力大型語言模型更好地與 Nostr 網絡進行交互。

項目相關鏈接

✨ 主要特性

此服務器實現了與 Nostr 網絡交互的七種工具：

1. getProfile：通過公鑰獲取用戶的資料信息。
2. getKind1Notes：獲取用戶創作的文本筆記（類型 1）。
3. getLongFormNotes：獲取用戶創作的長篇內容（類型 30023）。
4. getSentZaps：獲取用戶發出的 zap 記錄。
5. getReceivedZaps：獲取用戶收到的 zap 記錄。
6. getAllZaps：獲取用戶的全部 zap 記錄（包括髮送、接收和自我 zap）。
7. searchNIPs：搜索與特定主題相關的 Nostr 改進協議（NIP）。

服務器支持 npub 格式，並自動處理 npub 與公鑰之間的轉換，查詢結果會以用戶友好的 npub 標識符顯示。

📦 安裝指南

1. 克隆倉庫：

   git clone https://github.com/yourusername/nostr-mcp-server.git
   cd nostr-mcp-server
   

2. 安裝依賴：

   npm install
   

3. 啟動服務器：

   npm run start
   

💻 使用示例

基礎用法

# 獲取用戶資料
Show me the profile for npub1qny3tkh0acurjx9n9hr4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8

# 獲取最新筆記
Show me the latest 20 notes from npub1qny3tkh0acurjx9n9hr4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8

# 獲取 zap 記錄
Show me all zaps for npub1qny3tkh0acurjx9n9hr4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 with validation and debug enabled

# 搜索 NIP
Search for NIPs about zaps with full content

高級用法

# 指定自定義中繼
Show me the profile for npub1qny3tkh0acurjx9n9hr4nhrjz5zd8ne6dvrjehx9n9hr3lnj08qwuzwc8 using relay wss://relay.damus.io

# 控制返回結果數量
Show me the top 5 NIPs about relays

🔧 技術細節

• 原生支持 npub 格式，符合 NIP - 19 編碼/解碼規範。
• 遵循 NIP - 57 標準的 zap 收據檢測，具備方向感知（發送/接收/自我）。
• 高級 bolt11 發票解析，支持支付金額提取。
• 智能緩存系統，提升大數據量下的性能表現。
• 總薩特計算，統計發送、接收和淨餘額。
• 可選 NIP - 57 驗證，確保 zap 收據的完整性。

📚 詳細文檔

限制說明

• 查詢默認超時時間為 8 秒，防止長時間無響應。
• 僅支持公鑰的十六進制格式或 npub 格式。
• 默認使用部分中繼節點。

開發指南

1. 修改或擴展服務器功能，請編輯項目根目錄下的相關文件：

   • index.ts：主服務器及工具註冊。
   • zap - tools.ts：zap 相關功能（如 getSentZaps、getReceivedZaps、getAllZaps）。
   • nips - tools.ts：NIPs 搜索功能實現。

2. 編譯代碼：

   npm run build
   

3. 重啟 Claude 的 MCP 服務，加載最新更改。

代碼庫按模塊組織：

• 核心服務器設置和資料、筆記相關工具位於 index.ts。
• zap 功能在 zap - tools.ts 中封裝。
• NIPs 搜索實現於 nips - tools.ts。

這種模塊化結構使代碼更易維護，並便於添加新功能。