mcpField
C
Comunio

Comunio

ローカル
github.comゲーム・エンタメ12 週間前に更新
リポジトリ公式サイト

Comunio について

Comunioは、Comunioのファンタジーフットボール利用者やAIアシスタント向けに、リーグ情報の参照とチーム操作を提供するMCPサーバーです。非公式APIを読み取り・書き込みツールに変換し、変更操作はクライアントに承認を求めます。

主な機能

  1. 01チーム、マーケット、オファー、順位の照会
  2. 02移籍履歴の確認
  3. 03入札とオファーの受諾
  4. 04チームのラインナップ設定
  5. 05書き込み時のクライアント承認

活用シーン

  1. 01チーム編成とリーグ順位の確認
  2. 02マーケットを見て選手に入札
  3. 03オファーの受諾やラインナップの調整

MCP 対応

チーム、マーケット、オファー、順位、移籍を照会するツールと、入札、オファー受諾、ラインナップ設定のツールをMCPクライアントに提供します。書き込み操作にはクライアントが事前承認できるよう目印が付いています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "josetorronteras-comunio": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "COMUNIO_USERNAME",
        "-e",
        "COMUNIO_PASSWORD",
        "-e",
        "COMUNIO_TIMEZONE",
        "-e",
        "COMUNIO_USER_AGENT",
        "ghcr.io/josetorronteras/comunio-mcp:1.0.2"
      ],
      "env": {
        "COMUNIO_USERNAME": "<COMUNIO_USERNAME>",
        "COMUNIO_PASSWORD": "<COMUNIO_PASSWORD>",
        "COMUNIO_TIMEZONE": "<COMUNIO_TIMEZONE>",
        "COMUNIO_USER_AGENT": "<COMUNIO_USER_AGENT>"
      }
    }
  }
}
起動コマンドdocker run -i --rm -e COMUNIO_USERNAME -e COMUNIO_PASSWORD -e COMUNIO_TIMEZONE -e COMUNIO_USER_AGENT ghcr.io/josetorronteras/comunio-mcp:1.0.2
設定が必要な環境変数
COMUNIO_USERNAMEEmail or username of the Comunio account the server acts for.
COMUNIO_PASSWORDシークレットPassword of that Comunio account.
COMUNIO_TIMEZONEIANA timezone used for the x-timezone header and the login offset. Defaults to Europe/Madrid.
COMUNIO_USER_AGENTOverrides the browser user agent sent to Comunio. Only needed if the API starts refusing the default.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocighcr.io/josetorronteras/comunio-mcp:1.0.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Comunio MCP

CI codecov MCP Registry License: MIT

Comunio向けのMCP（Model Context Protocol）サーバーです。Comunioはオンラインのファンタジーサッカーマネージャーです。

AI アシスタントがあなたのリーグ（チーム、マーケット、オファー、順位表、移籍）にアクセスできるようにし、あなたに代わって入札、選手の売却、ラインナップの設定を行います。client ↔ MCP ↔ Comunio の1行で表すと、このサーバーはその中央部分です。

ステータス：実際のアカウントで毎日使用中です。 チーム、マーケット、オファー、順位表、移籍の読み取りと、マーケット、入札、ラインナップの操作を行う19個のツールがあります。Comunioの非公式APIを利用しており、予告なく変更される場合があります。対応済みの内容と未対応の内容については、docs/comunio-api.mdを参照してください。

仕組み

ツールには2種類あり、名前からどちらかが分かります。

種類命名機能
読み取りget_squad、get_market、get_offers照会のみです。何も変更しません。常に安全です。
書き込みplace_bid、accept_offer、set_lineupチームを変更したり、資金を使ったりします。

この仕組みには、次の2つの特徴があります。

このサーバーにはAIモデルも戦略も内蔵されていません。 このサーバーの役割は翻訳です。ComunioのAPIを呼び出せるようにし、その応答を理解しやすくします。スロット番号を解読したり、あるエンドポイントが「データなし」を5通りの方法で表す問題を整理したり、すべての行で0になっているランキング項目を見極めたりします。どの選手を獲得するかは、すでに利用しているアシスタントに任せます。APIキーもGPUも不要で、推論コストもかかりません。

クライアントは、操作を実行する前にあなたに確認します。 状態を変更するすべてのツールは、そのことを明示するため、MCPクライアントは処理を止めて事前にあなたに確認できます。あなたが同意した後、サーバーが操作を再検討することはありません。また、成功したと決めつけず、Comunioから実際に返された内容を報告します。

必要条件

  • Docker。
  • Comunioアカウント。APIキーも登録手続きも不要です。サーバーがあなたとしてログインします。

ホストにほかのものをインストールする必要はありません。

クイックスタート

イメージは公開済みなので、クローンもビルドも不要です。シェルに記憶されるコマンドに認証情報を含めるのではなく、自分だけが読み取れるファイルに保存してください。

install -m 600 /dev/null ~/.comunio.env
$EDITOR ~/.comunio.env      # COMUNIO_USERNAME=you
                            # COMUNIO_PASSWORD=...

claude mcp add comunio -- docker run -i --rm \
  --env-file "$HOME/.comunio.env" \
  ghcr.io/josetorronteras/comunio-mcp

その後、チームの状況をアシスタントに尋ねてみてください。get_accountを使うと、認証情報が有効かどうかを最も手早く確認できます。

Claude Desktopの設定、Dockerを使わないuvxの方法、各変数の役割については、docs/setup.mdを参照してください。

ドキュメント

コントリビューション

Issueやプルリクエストを歓迎します。CONTRIBUTING.mdでは、セットアップ方法、サーバーに含めるものと含めないもの、そして譲れないルール（コミットに認証情報、トークン、実際のアカウントデータを含めないこと）を説明しています。脆弱性については、公開IssueではなくSECURITY.mdに従って報告してください。

バージョニング

リリースにはセマンティック バージョニングを採用しており、対象となるのはMCP のインターフェースです。ツール名、入力スキーマ、レスポンスに含まれるフィールドが対象です。ツール名の変更、パラメーターの削除、レスポンスからのフィールドの削除はメジャーバージョンアップとなります。ツール、オプションのパラメーター、フィールドの追加はマイナーバージョンアップとなります。

一方、Comunio は対象外です。このプロジェクトは非公式 API と通信するため、API は予告なく変更されたり、動作しなくなったりする可能性があります。ここでどのようなバージョン番号を付けても、それを防げるわけではありません。API に変更があった場合、修正はパッチまたはマイナーリリースとして提供され、ツールの形式は変わりません。

ライセンス

MIT。

免責事項

これは非公式プロジェクトであり、Comunio とは提携していません。ご自身のアカウントを使用し、自己責任でご利用ください。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。