Nostr MCP Server

🚀 Nostr匿名發帖服務器實現說明

Nostr匿名發帖服務器提供了一系列強大的功能，能夠滿足匿名發帖及相關交互的需求。它具備多種特性，如對npub格式的本地支持、NIP - 57兼容的zap收據檢測等，同時提供了清晰的安裝和開發指南。

🚀 快速開始

按照以下步驟安裝並啟動Nostr匿名發帖服務器：

1. 從以下鏈接克隆代碼倉庫:

   git clone https://github.com/your-username/nostr-server.git
   

2. 安裝依賴項:

   cd nostr-server
   npm install
   

3. 編譯代碼:

   npm run build
   

4. 啟動服務器:

   node dist/index.js
   

✨ 主要特性

• 對npub格式的本地支持：通過NIP - 19協議實現編碼和解碼
• NIP - 57兼容的zap收據檢測：帶有方向感知（發送/接收/自我）
• 高級bolt11發票解析：具備金額提取功能
• 智能緩存系統：優化大量zap數據的性能
• 總金額計算：針對發送/接收/自我的zap，提供淨餘額計算
• 可選NIP - 57驗證：確保zap收據的完整性
• 匿名zap支持：生成閃電發票進行支付
• 多類型目標支持：包括個人資料、事件（note ID）、以及可替代事件（naddr）
• 工具調用即建立新連接：每次工具調用都會創建新的中繼連接，確保數據可靠性

📦 安裝指南

克隆代碼倉庫

git clone https://github.com/your-username/nostr-server.git

安裝依賴

cd nostr-server
npm install

編譯代碼

npm run build

啟動服務器

node dist/index.js

📚 詳細文檔

限制說明

• 查詢默認設置8秒超時
• 僅支持hex格式或npub格式的公鑰
• 默認情況下僅使用部分中繼服務器

開發指南

若要對本服務器進行修改或擴展，可按以下步驟操作：

1. 編輯項目根目錄下的相關文件：
   • index.ts：主要包含服務器設置和工具註冊
   • zap-tools.ts：實現與zap相關的功能（獲取已發送zap、接收zap及所有zap）
   • nips-tools.ts：實現NIP搜索功能
2. 編譯代碼:

   npm run build
   

3. 重啟Claude桌面版或Cursor以應用更改。

🔧 技術細節

代碼結構

• 核心服務器設置及相關工具位於index.ts
• Zap相關功能集中在zap-tools.ts
• NIP搜索實現位於nips-tools.ts

這種模塊化設計使得代碼庫更易維護，也便於添加新功能。