内容
# JKTJJ MCP 服务器
[](https://smithery.ai/server/jktjj-com/jktjj-mcp)
[](https://opensource.org/licenses/MIT)
用于 AI 代理访问 JKTJJ 结构化巴西柔术数据的 MCP 服务器 — 全球的道馆、教练、赛事和城市。
## 安装
### opencode
在您的 `opencode.json` 中添加：
```json
{
"mcp": {
"jktjj": {
"type": "remote",
"url": "https://mcp.jktjj.com/mcp",
"enabled": true
}
}
}
```
### Claude Desktop
在 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"jktjj": {
"type": "url",
"url": "https://mcp.jktjj.com/mcp"
}
}
}
```
### Cursor
设置 → MCP 服务器 → 添加：
- 名称：`jktjj`
- 类型：`url`
- URL：`https://mcp.jktjj.com/mcp`
### Smithery
```bash
npx @smithery/cli mcp add jktjj-com/jktjj-mcp
```
### MCP Inspector
```bash
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` | 获取巴西柔术赛事的周总结 |
## 代理发现
外部代理和机器人可以通过以下公共界面发现如何使用 MCP 服务器：
| 界面 | URL | 格式 |
|---|---|---|
| 公共技能 | `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 |
公共技能文件包含路由指南、决策默认值和查询示例。代理可以通过 HTTP GET 请求获取它，无需连接到 MCP 服务器。
## 注册
| 注册 | 状态 | URL |
|---|---|---|
| MCP 注册 | 待定 | https://registry.modelcontextprotocol.io |
| Smithery | 已发布 | https://smithery.ai/server/jktjj-com/jktjj-mcp |
| Cline 市场 | 已提交 | 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`
### 快速开始
```bash
npm install
npm run dev
```
服务器在 `http://localhost:8787` 启动。
### 部署
```bash
npm run deploy
```
### 测试
```bash
npm test
```
## 架构
MCP 服务器在启动时从 `jktjj.com/api/x402/data-snapshot` 获取数据快照，并每 5 分钟刷新一次。所有工具都从此内存快照中查询 — 运行时无需直接访问数据文件。
```text
jktjj.com/data/* → /api/x402/data-snapshot → mcp Worker（内存缓存） → MCP 工具
```
## 许可证
MIT
