Boardsesh Climbing Logbook

boardsesh-mcp

AI エージェントが、登ったことのあるすべてのボード（Kilter、Tension、MoonBoard、Decoy、Touchstone、So iLL、Woods、スプレーウォール）にわたって、あなたのBoardseshのクライミング記録を読み取り、分析できる非公式のMCPサーバーです。

前回のセッションはどうでしたか？ KilterとTensionでは、どちらのほうが強いですか？ 40°でのプロジェクトは何ですか？ 今の自分のレベルなら、次に何を試すべきですか？ グレードのピラミッドを見せてください。避けているホールドはどれですか？

読み取り専用です。Boardseshアカウントに書き込むことは一切ありません。

パスワードを渡す必要はありません。 Boardseshはクライミング記録を公開しているため、表示名だけでほとんどの機能を利用できます。認証情報は任意で、利用できる機能が追加されるだけです。

エージェントに追加する

Kiro

MCP設定を開き（コマンドパレット → Kiro: ユーザーMCP設定を開く（JSON））、次を追加します。

{
  "mcpServers": {
    "boardsesh": {
      "command": "uvx",
      "args": ["boardsesh-mcp"],
      "env": {
        "BOARDSESH_USER": "Your Boardsesh Display Name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

これで設定は完了です。BOARDSESH_USERには、Boardseshプロフィールの表示名を指定します（希望する場合はユーザーIDでも構いません）。uvのインストールが必要です。uvxはuvに同梱されています。

その他のクライアント

どのクライアントでも、必要な情報は同じ3つです。コマンドはuvx、引数は["boardsesh-mcp"]、環境変数はBOARDSESH_USERです。Claude Desktop、Claude Code、Codex、Cursor、VS Code、Windsurf、Gemini CLI、Zed向けの設定をコピーして貼り付けるには、docs/clients.mdをご覧ください。

任意：残りの機能を有効にする

4つのツールでは、使用している物理ボードのセットアップ（レイアウト、サイズ、ホールドセット）を把握する必要がありますが、この情報を見られるのはログイン中の所有者だけです。これらのツールを有効にするには、Boardseshのログイン情報を追加します。

"env": {
  "BOARDSESH_USER": "Your Display Name",
  "BOARDSESH_EMAIL": "${BOARDSESH_EMAIL}",
  "BOARDSESH_PASSWORD": "${BOARDSESH_PASSWORD}"
}

該当する4つのツールは、boardsesh_recommend_climbs、boardsesh_search_climbs、boardsesh_find_similar_climbs、boardsesh_get_hold_heatmapです。それ以外のすべての機能は、これらの情報なしで利用できます。詳しくは環境変数の設定方法をご覧ください。

任意：タイムゾーン

セッションは、サーバーを実行しているマシンから検出したタイムゾーンに基づき、暦日ごとにまとめられます。タイムゾーンが正しくない場合は、"BOARDSESH_TIMEZONE": "Europe/Rome"（任意のIANA名）を追加してください。

質問の例

Summarise my Boardsesh logbook.
How did my last session go?
Compare my climbing on Kilter and Tension — where am I actually stronger?
What are my current projects, and which have I tried the most?
Show my grade pyramid and my flash rate per grade.
Have I improved over the last six months?
What should I try next at my level?
Find climbs similar to the one I sent yesterday.
Which holds show up most in climbs one grade above me?

エージェントが利用できるツール

BOARDSESH_USERだけで利用できます。

ツール	返される内容
boardsesh_get_summary	全ボードの合計：完登数、フラッシュ数、セッション数、期間、最難完登
boardsesh_get_ascents	クライミング記録。ボード、角度、結果、期間で絞り込み可能
boardsesh_get_sessions	日ごとにまとめた記録
boardsesh_get_projects	試登したものの完登していない課題。ボード、課題、角度ごと
boardsesh_compare_boards	ボードごとに1行で表示。ボード間でグレードを正規化
boardsesh_get_grade_pyramid	グレードごとの完登数とフラッシュ率
boardsesh_get_progression	月ごと、または週ごとの推移
boardsesh_get_grades	ボードのグレード尺度（難易度IDからラベルへの対応）

BOARDSESH_EMAIL / BOARDSESH_PASSWORDが必要です。

ツール	返される内容
boardsesh_recommend_climbs	次に試す課題：自分のレベルに合った課題、人気課題、隠れた名課題、新着課題
boardsesh_search_climbs	名前、グレード範囲、ベンチマーク、人気度でカタログを検索
boardsesh_find_similar_climbs	指定した課題とホールドを共有する課題
boardsesh_get_hold_heatmap	壁の課題で使われているホールド。苦手な部分を見つけるのに役立ちます

データの解釈方法

• ログブックの1件の記録は、1つのボードで、1つの角度で、1回のセッションに登った1つの課題を表し、トライ数も含みます。記録は重複排除されないため、同じ課題が何度も記録されることがあります。
• status が正確な状態を示します。flash（1トライ目で完登）、send（トライを重ねて完登）、または attempt（未完登）のいずれかです。トライ数から状態が推測されることはありません。
• プロジェクトとは、トライしたものの未完登の (board, climb, angle) です。別の角度で完登しても、プロジェクトからは削除されません。
• grade はボード独自のグレード、difficulty_id は生の ID です。ボードごとのグレードはボード間で比較できないため、boardsesh_compare_boards が使用するのは boardsesh_grade（Boardsesh によるボード間比較用の正規化された数値）です。実際の完登記録による裏付けがなく、Boardsesh の信頼度が十分でない場合は null になります。
• 「セッション」とは、ユーザーのタイムゾーンにおける1暦日です。

セキュリティとプライバシー

• デフォルト設定では、漏洩する秘密情報はありません。設定するのは公開表示名のみで、読み取られる情報はすべて、Boardsesh のプロフィールですでに公開されているものです。
• 認証情報を追加した場合は、Boardsesh 独自のログインエンドポイントからトークンを取得するために、一度だけ使用されます。トークンはプロセスの実行中のみメモリ上に保存され、ディスクには書き込まれません。
• 認証情報とトークンがツールの出力、ログ、エラーメッセージに含まれることはありません。
• サーバーは ws.boardsesh.com と www.boardsesh.com とのみ通信します。テレメトリーはありません。
• すべてのツールは読み取り専用で、GraphQL レイヤーから送信できるのは固定された読み取りクエリのみです。ミューテーションに到達するコードパスはありません。
• エージェントが何個のツールを呼び出しても、ログブックの取得は1分に1回までです。

トラブルシューティングでは、同じ環境変数を設定して uvx boardsesh-mcp --check を実行してください。件数と設定のみが出力され、記録や秘密情報は含まれないため、問題として投稿しても安全です。

Boardsesh および kilter-mcp との関係

Boardsesh は、複数のボードのログブックを集約して API を公開する、Apache-2.0 ライセンスのオープンソースのボードクライミングアプリです。このプロジェクトは、メンテナーの提案を受けて開発された独立した MCP クライアントですが、公式の Boardsesh 製品ではありません。また、ここで発生したバグの責任は私にあり、Boardsesh にはありません。

Kilter Board だけで登り、Boardsesh を使わない場合は、kilter-mcp を使うと Kilter に直接接続できます。複数のボードを使う場合は、ボード間を比較できるため、boardsesh-mcp のほうが適しています。

コントリビューション

Issue とプルリクエストを歓迎します。CONTRIBUTING.md をご覧ください。セキュリティに関する報告は SECURITY.md からお願いします。

ライセンス

MIT