JKTJJ MCP Server

JKTJJ MCP サーバー

世界各地のジム、コーチ、イベント、都市に関するJKTJJの構造化されたBJJデータに、AI エージェントがアクセスするためのMCP サーバーです。

インストール

opencode

opencode.jsonに追加します：

{
  "mcp": {
    "jktjj": {
      "type": "remote",
      "url": "https://mcp.jktjj.com/mcp",
      "enabled": true
    }
  }
}

Claude Desktop

claude_desktop_config.jsonに追加します：

{
  "mcpServers": {
    "jktjj": {
      "type": "url",
      "url": "https://mcp.jktjj.com/mcp"
    }
  }
}

Cursor

設定 → MCP サーバー → 追加：

• 名前：jktjj
• 種類：url
• URL：https://mcp.jktjj.com/mcp

Smithery

npx @smithery/cli mcp add jktjj-com/jktjj-mcp

MCP Inspector

npx @modelcontextprotocol/inspector

その後、https://mcp.jktjj.com/mcpに接続します。

リモートURL

https://mcp.jktjj.com/mcp

ツール

無料ツール（認証不要）

ツール	説明
list_cities	対応している都市の一覧を取得します。国別に絞り込めます
get_city	スラッグで都市の詳細情報を取得します
list_gyms	ジムの一覧を絞り込んで取得します（都市、ギ／ノーギ、オープンマット、所属団体、インストラクター）
get_gym	都市とジムのスラッグでジムのプロフィール全体を取得します
list_events	イベントの一覧を絞り込んで取得します（都市、期間、種類）
get_event	スラッグでイベントの詳細情報を取得します

プレミアムツール（x402 USDC — 1回あたり$0.005～$0.02）

ツール	説明	価格
search_schedule	都市内の曜日、時間、クラスの種類でスケジュールを検索します	$0.02
find_open_mats	都市と曜日でオープンマットのセッションを検索します	$0.005
search_jktjj	複数のインデックスを横断してテキスト検索します（都市、ジム、コーチ、イベント）	$0.005
list_coaches	コーチの一覧を絞り込んで取得します（都市、所属団体）	$0.005
get_coach	スラッグでコーチのプロフィール全体を取得します	$0.005
get_schedule	ジム、または都市内すべてのジムの週間スケジュールを取得します	$0.005
bulk_export	都市単位のデータをエクスポートします（ジム、イベント、コーチ）	$0.005

リソース

URI	説明
jktjj://catalog	エンドポイント、価格、最適化のヒントを含むAPIカタログ
jktjj://agent-guide	ルーティング手順、既定の判断基準、クエリ例
jktjj://llms.txt	JKTJJのllms.txtの内容
jktjj://snapshot	現在のスナップショットのバージョンと件数

プロンプト

プロンプト	説明
plan_training_trip	都市と期間を指定して、トレーニングの旅程を作成します
find_open_mat	特定の日に都市で開催されるオープンマットのセッションを探します
summarize_week_in_bjj	BJJイベントの週間サマリーを取得します

エージェントによる検出

外部のエージェントやボットは、以下の公開サーフェスを通じてMCP サーバーの使い方を確認できます。

サーフェス	URL	形式
Well-known skill	https://jktjj.com/.well-known/jktjj/SKILL.md	Markdown
MCP リソース	jktjj://agent-guide	Markdown（接続後）
llms.txt	https://jktjj.com/llms.txt	プレーンテキスト
カタログ（HTTP）	https://jktjj.com/api/x402/v1/catalog	JSON
開発者向け	https://jktjj.com/for-developers	HTML

well-knownのSKILL.mdには、ルーティング手順、既定の判断基準、クエリ例が記載されています。エージェントはMCP サーバーに接続せず、HTTP GETで取得できます。

レジストリ

レジストリ	ステータス	URL
MCP Registry	保留中	https://registry.modelcontextprotocol.io
Smithery	公開済み	https://smithery.ai/server/jktjj-com/jktjj-mcp
Cline Marketplace	申請済み	https://github.com/cline/mcp-marketplace/issues
MCP.Directory	申請済み	https://mcp.directory
MCP.so	申請済み	https://mcp.so

開発

前提条件

• Node.js
• Workersを有効にしたCloudflareアカウント
• Cloudflare DNSで設定済みのドメインmcp.jktjj.com

クイックスタート

npm install
npm run dev

サーバーはhttp://localhost:8787で起動します。

デプロイ

npm run deploy

テスト

npm test

アーキテクチャ

MCP サーバーは起動時にjktjj.com/api/x402/data-snapshotからデータスナップショットを取得し、5分ごとに更新します。すべてのツールはこのメモリ内スナップショットを参照して処理します。実行時にデータファイルへ直接アクセスすることはありません。

jktjj.com/data/*  →  /api/x402/data-snapshot  →  mcp Worker (in-memory cache)  →  MCP tools

ライセンス

MIT