Lichess

@pipeworx/lichess

Lichess.org の公開 API 向け MCP — プレイヤープロフィール、棋譜、配信、オープニングエクスプローラー、テーブルベース。API キーは不要です。

Pipeworx の一部です — AI エージェントを 1882 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式の連携であり、上流のプロバイダーとは提携しておらず、承認や公開も受けていません。

ツール

• user(username) — プレイヤープロフィールと各バリアントのレーティング
• users(usernames[]) — 一括検索（最大 300 件）
• user_status(usernames[]) — オンライン／対局中のステータス
• user_performance(username, perf) — 単一バリアントの成績と最高レーティングの棋譜
• top_players(perf, limit?) — バリアント別のトッププレイヤー（bullet/blitz/rapid/classical など）
• leaderboards() — 全バリアントのトップ 10
• tv_channels() — バリアント別の現在注目されている TV 対局
• cloud_eval(fen, multi_pv?) — FEN 局面のエンジンクラウド評価
• tablebase(fen, variant?) — Syzygy テーブルベースの結果（駒数 ≤7）
• opening_explorer(scope, fen|play, ...) — Lichess／masters／player のオープニングデータベース

データソース

https://lichess.org/api、https://explorer.lichess.ovh、https://tablebase.lichess.ovh。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "lichess": {
      "url": "https://gateway.pipeworx.io/lichess/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/lichess/mcp の tools/list は、上の表にあるツールに加えて、Pipeworx 共通のメタツール — ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群 — も返します。そのため、表示されるツール数はこの表より多くなります。単一パックのエンドポイントには現在、パック固有のツールとともに共通ツールがおよそ 30 個表示されます。接続の initialize 応答には正確な対象範囲が記載されており、その日における正式な情報源です。

これは意図的な設計であり、意図せず多重化されているわけではありません。メタツールを使えば、このパックで対応していない質問にも ask_pipeworx 経由でカタログ全体を検索して回答できるため、MCP サーバーをもう 1 つ追加する必要がありません。現在、メタツールなしでパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

このパックのツールだけでなく、すべてのパックのツールを直接一覧表示するには、Pipeworx のフルゲートウェイに接続します。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと 1882 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx ですべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/lichess_user \
  -H 'Content-Type: application/json' \
  -d '{"username":"hikaru"}'

最初の呼び出しにアカウントは不要です。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/lichess_user を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます — Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

{
  "mcpServers": {
    "lichess": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-lichess"]
    }
  }
}

または、直接実行して起動を確認します。

npx -y @pipeworx/mcp-lichess

stdin/stdout 経由で MCP 通信を行い、initialize／tools/list／tools/call に応答します。対象はこのパックのツールのみで、上記のゲートウェイ接続で追加される共通メタツールは含まれません。同じデータソース、同じツールですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます — 上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Lichess data" })

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT