JKTJJ MCP Server

JKTJJ MCP 服务

供 AI Agent 访问 JKTJJ 结构化 BJJ 数据的 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 Servers → 添加：

• 名称：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	根据 slug 获取完整城市详情
list_gyms	筛选道馆列表（城市、gi/nogi、开放训练、所属联盟、教练）
get_gym	根据城市和道馆 slug 获取完整道馆资料
list_events	筛选赛事列表（城市、日期范围、类型）
get_event	根据 slug 获取完整赛事详情

高级工具（x402 USDC — 每次调用 $0.005–$0.02）

工具	描述	价格
search_schedule	按星期、时间和课程类型搜索城市内的课程表	$0.02
find_open_mats	按城市和星期查找开放训练课程	$0.005
search_jktjj	跨索引文本搜索（城市、道馆、教练、赛事）	$0.005
list_coaches	筛选教练列表（城市、所属联盟）	$0.005
get_coach	根据 slug 获取完整教练资料	$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 赛事每周摘要

Agent 发现

外部 Agent 和机器人可以通过以下公开入口了解如何使用 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 包含路由说明、默认决策和查询示例。Agent 无需连接 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