Gatherings MCP

🚀 聚会 MCP サーバー

このサーバーは、TypeScript をベースに構築された MCP サーバーで、聚会の管理と費用の分配を行うことができます。社交活動における支出と支払い状況を追跡し、友人間の返済計算や差額の決済を簡単に行えるように支援します。

🚀 クイックスタート

このサーバーは、社交活動の費用管理を容易にするために開発されました。以下の手順でサーバーを起動し、機能を利用することができます。

✨ 主な機能

ツール

• 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 を受け取ります。

📦 インストール

設定

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
    }
  }
}

設定オプション

• command と args：サーバーの実行方法を指定します。
• env：環境変数です。
  • GATHERINGS_DB_PATH：データベースファイルのパスです。
  • GATHERINGS_SCRIPT：聚会操作を処理する Python スクリプトのパスです。
• alwaysAllow：自動で許可されるツールのリストです。
• timeout：最大実行時間（秒）です。

デバッグ

MCP サーバーは stdio を介して通信するため、デバッグが難しい場合があります。MCP Inspector を使用することをおすすめします。これはパッケージスクリプトとして利用できます。

npm run inspector

Inspector はデバッグツールにアクセスするための URL を提供し、ブラウザで開くことができます。

🔧 技術詳細

注意事項：アーキテクチャ

重要：このプロジェクトは、Node.js アプリケーションを実装するために非標準的なアーキテクチャを採用しています。TypeScript MCP サーバーは、Python バックエンドをラッピングする形で実装されています。Node.js サーバーは MCP リクエストを受け取り、それを Python スクリプトへのコマンドライン呼び出しに変換し、結果を返します。

現在のアーキテクチャは我々のニーズを満たしていますが、本番環境でのアプリケーションには、最も効率的で保守しやすい方法ではありません。

今後の予定

• より標準的なアーキテクチャにリファクタリングする：
  • バックエンドを完全に TypeScript/JavaScript に移行する
  • または、Node.js と Python コンポーネント間に適切なプロセス間通信を実装する
  • または、REST API で置き換え、Python バックエンドが MCP サーバーが使用する API を提供する
• Node.js と Python コンポーネント間のエラーハンドリングを改善する
• コンポーネント間の統合に自動化テストを追加する
• Dockerfile を最適化する

💻 使用例

基本的な使用法

# 依存関係のインストール
npm install
# サーバーのビルド
npm run build
# 自動再構築を伴う開発
npm run watch