Gatherings MCP Python

🚀 聚會 MCP 服務器

這是一個用於管理聚會和費用分攤的模型上下文協議（Model Context Protocol）服務器，它能讓 AI 系統助力用戶管理社交活動、外出或各類聚會的共享費用。

🚀 快速開始

Gatherings MCP 服務器提供了一個 API，允許 AI 助手通過機器對話協議（Machine Conversation Protocol）與 Gatherings 應用程序交互。啟動 MCP 服務器的命令如下：

python gatherings_mcp_server.py

該服務器在標準輸入輸出上運行，使其與 MCP 協議客戶端兼容。

✨ 主要特性

• 👥 創建和管理具有多個成員的聚會
• 💸 為特定成員添加費用
• 📊 計算公平報銷
• 📝 記錄支付和報銷
• 📄 生成詳細的支付摘要
• ➕➖ 添加/移除聚會成員
• ✏️ 隨時重命名成員

📦 安裝指南

先決條件

• Python 3.8+
• SQLAlchemy
• MCP SDK

設置

1. 克隆此倉庫：

   git clone https://your-repository.git
   cd accel
   

2. 安裝所需的依賴項： 該項目使用 uv 進行 Python 依賴管理，而不是 pip。此更改是由於對 模型上下文協議 Python SDK 的依賴要求。 確保你已經安裝了 uv 或者通過以下命令進行安裝：

   pip install uv
   

   要安裝項目依賴項：

   uv pip install -r requirements.txt
   

3. 設置環境變量（可選）：

   # 自定義數據庫位置
   export GATHERINGS_DB_PATH=path/to/database.db
   
   # 自定義腳本位置
   export GATHERINGS_SCRIPT=path/to/gatherings.py
   

💻 使用示例

基礎用法

啟動 MCP 服務器：

python gatherings_mcp_server.py

📚 詳細文檔

API 參考

MCP 服務器公開了以下工具：

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。