Gatherings MCP

🚀 聚會 MCP 服務器

這是一個基於 TypeScript 的 MCP 服務器，主要用於管理聚會以及費用分攤。它能夠幫助用戶跟蹤社交活動中的支出和支付情況，讓計算報銷金額、結算朋友間的費用差額變得輕鬆簡單。

🚀 快速開始

開發

• 安裝依賴項：

npm install

• 構建服務器：

npm run build

• 帶有自動重建的開發：

npm run watch

安裝

配置

若要與 Claude Desktop 配合使用，需添加以下服務器配置：

{
  "mcpServers": {
    "gatherings": {
      "command": "node",
      "args": ["/path/to/gatherings-server/build/index.js"],
      "env": {
        "GATHERINGS_DB_PATH": "gatherings.db",
        "GATHERINGS_SCRIPT": "/path/to/gatherings-server/gatherings.py"
      },
      "disabled": false,
      "autoApprove": [],
      "alwaysAllow": [
        "create_gathering",
        "add_expense",
        "calculate_reimbursements",
        "record_payment",
        "rename_member", 
        "show_gathering",
        "list_gatherings",
        "close_gathering",
        "delete_gathering",
        "add_member",
        "remove_member"
      ],
      "timeout": 300
    }
  }
}

配置選項

調試

由於 MCP 服務器通過 stdio 進行通信，調試可能會有一定難度。我們推薦使用 MCP Inspector，它可作為包腳本使用：

npm run inspector

Inspector 會提供一個用於訪問調試工具的 URL，在瀏覽器中打開該 URL 即可進行調試。

✨ 主要特性

工具

• create_gathering - 創建新的聚會
  • 需接受 gathering_id 和 members 作為必需參數
• add_expense - 為成員添加支出
  • 需接受 gathering_id、member_name 和 amount 作為必需參數
• calculate_reimbursements - 計算聚會的報銷金額
  • 需接受 gathering_id 作為必需參數
• record_payment - 記錄成員的支付
  • 需接受 gathering_id、member_name 和 amount 作為必需參數
• rename_member - 重命名無名成員
  • 需接受 gathering_id、old_name 和 new_name 作為必需參數
• show_gathering - 顯示聚會的詳細信息
  • 需接受 gathering_id 作為必需參數
• list_gatherings - 列出所有聚會
• close_gathering - 關閉一個聚會
  • 需接受 gathering_id 作為必需參數，可選 force 參數
• delete_gathering - 刪除一個聚會
  • 需接受 gathering_id 作為必需參數，可選 force 參數
• add_member - 向聚會添加新成員
  • 需接受 gathering_id 和 member_name 作為必需參數
• remove_member - 將成員從聚會中移除
  • 需接受 gathering_id 和 member_name 作為必需參數

🔧 技術細節

注意事項：架構

⚠️ 重要提示

此項目採用了一種非標準的架構來實現 Node.js 應用程序。TypeScript MCP 服務器作為包裝器圍繞一個 Python 後端實現。Node.js 服務器接收 MCP 請求，將其轉換為對 Python 腳本的命令行調用，並返回結果。

儘管當前這種架構滿足了我們的需求，但對於生產應用來說，這不是最高效或最容易維護的方法。

待辦事項

• 將實現重構為更標準的架構：
  • 完全將後端遷移到 TypeScript/JavaScript
  • 或者在 Node.js 和 Python 組件之間實現適當的進程間通信
  • 或者用 REST API 替換，其中 Python 後端提供 MCP 服務器使用的 API
• 改進 Node.js 和 Python 組件之間的錯誤處理
• 為組件之間的集成添加自動化測試
• 優化 Dockerfile