JKTJJ MCP Server

io.github.jktjj由 GitHub 账号 jktjj 发布v0.1.0更新于 Nov 2, 2026

BJJ gym, coach, event, and city data for AI agents. Free base tools, x402-paid premium.

已验证Streamable HTTP可网页运行位置与生活商业与电商

概览

AI 生成的概览

远程 MCP 服务器，为助手提供城市、道馆、教练和赛事等巴西柔术结构化数据，部分工具按次付费。

可以做什么
  • 按国家浏览城市列表并查看城市详情
  • 按城市列出和查看道馆资料，可按 gi/nogi、开放垫、所属组织、教练筛选
  • 按城市、日期范围和类型列出和查看赛事详情
  • 搜索教练、课程表与开放垫场次，并进行跨索引文本搜索
  • 按城市批量导出数据
  • 读取目录、agent-guide 和快照资源，并使用训练行程规划等提示模板
适用场景
适合助手回答关于支持城市中柔术道馆、教练、课程表、开放垫或赛事的问题，或规划训练行程。免费工具覆盖基本的城市、道馆和赛事查询；课程表、教练和搜索类工具按次计费。
运行要求
需要远程 MCP 端点；未声明本地运行时、账号或 API 密钥。README 给出了 opencode、Claude Desktop、Cursor 和 MCP Inspector 等客户端的服务器地址。高级工具需通过 x402 以 USDC 付费。
安装前请注意
除基本的城市、道馆和赛事查询外，多数工具为高级工具，按次以 USDC 收费（约每次 0.005–0.02 美元），助手若随意调用可能产生费用。付费通过 x402 协议完成，可能涉及钱包或支付凭证。数据来自每五分钟刷新的快照，结果可能有延迟。

安装

在 SourceWeft 中

  1. 打开 控制台中的 JKTJJ MCP Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.jktjj%2Fjktjj-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

README

JKTJJ MCP Server

[Smithery] [License: MIT]

MCP server for AI agent access to JKTJJ's structured BJJ data — gyms, coaches, events, and cities worldwide.

Install

opencode

Add to your opencode.json:

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

Claude Desktop

Add to claude_desktop_config.json:

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

Cursor

Settings → MCP Servers → Add:

  • Name: jktjj
  • Type: url
  • URL: https://mcp.jktjj.com/mcp

Smithery

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

MCP Inspector

bash
npx @modelcontextprotocol/inspector

Then connect to https://mcp.jktjj.com/mcp.

Remote URL

https://mcp.jktjj.com/mcp

Tools

Free Tools (no auth required)

ToolDescription
list_citiesList supported cities, filterable by country
get_cityFull city details by slug
list_gymsFiltered gym list (city, gi/nogi, open mat, affiliation, instructor)
get_gymFull gym profile by city + gym slug
list_eventsFiltered event list (city, date range, type)
get_eventFull event details by slug

Premium Tools (x402 USDC — $0.005–$0.02/call)

ToolDescriptionPrice
search_scheduleSearch schedules by day, time, class type across a city$0.02
find_open_matsOpen mat sessions by city and day$0.005
search_jktjjCross-index text search (cities, gyms, coaches, events)$0.005
list_coachesFiltered coach list (city, affiliation)$0.005
get_coachFull coach profile by slug$0.005
get_scheduleWeekly schedule for a gym or all gyms in a city$0.005
bulk_exportCity-level data export (gyms, events, coaches)$0.005

Resources

URIDescription
jktjj://catalogAPI catalog with endpoints, pricing, and optimization hints
jktjj://agent-guideRouting instructions, decision defaults, and query examples
jktjj://llms.txtJKTJJ llms.txt content
jktjj://snapshotCurrent snapshot version and counts

Prompts

PromptDescription
plan_training_tripBuild a training itinerary for a city and date range
find_open_matFind open mat sessions in a city on a specific day
summarize_week_in_bjjGet a weekly summary of BJJ events

Agent Discovery

External agents and bots can discover how to use the MCP server through these public surfaces:

SurfaceURLFormat
Well-known skillhttps://jktjj.com/.well-known/jktjj/SKILL.mdMarkdown
MCP resourcejktjj://agent-guideMarkdown (after connecting)
llms.txthttps://jktjj.com/llms.txtPlain text
Catalog (HTTP)https://jktjj.com/api/x402/v1/catalogJSON
For Developershttps://jktjj.com/for-developersHTML

The well-known SKILL.md contains routing instructions, decision defaults, and query examples. Agents can fetch it via HTTP GET without connecting to the MCP server.

Registries

RegistryStatusURL
MCP RegistryPendinghttps://registry.modelcontextprotocol.io
SmitheryPublishedhttps://smithery.ai/server/jktjj-com/jktjj-mcp
Cline MarketplaceSubmittedhttps://github.com/cline/mcp-marketplace/issues
MCP.DirectorySubmittedhttps://mcp.directory
MCP.soSubmittedhttps://mcp.so

Development

Prerequisites

  • Node.js
  • Cloudflare account with Workers enabled
  • Domain mcp.jktjj.com configured in Cloudflare DNS

Quick Start

bash
npm installnpm run dev

The server starts on http://localhost:8787.

Deploy

bash
npm run deploy

Tests

bash
npm test

Architecture

The MCP server fetches a data snapshot from jktjj.com/api/x402/data-snapshot on boot and refreshes it every 5 minutes. All tools query from this in-memory snapshot — no direct data file access at runtime.

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

License

MIT

来源：README.md，提交 4e47ece

工具

13

list_cities

输入参数limitcountry

get_city

输入参数citySlug必填

list_gyms

输入参数hasGilimithasNogicitySlughasOpenMatopenMatDayaffiliationinstructorName

get_gym

输入参数gymSlug必填citySlug必填

list_coaches

输入参数limitcitySlugaffiliation

get_coach

输入参数coachSlug必填

list_events

输入参数tofromtypelimitcitySlug

get_event

输入参数eventSlug必填

search_jktjj

输入参数limitquery必填scope

find_open_mats

输入参数citySlug必填dayOfWeek

get_schedule

输入参数gymSlugcitySlug必填

search_schedule

输入参数limitcitySlug必填classTypedayOfWeektimeWindow

bulk_export

输入参数citySlug必填

版本历史

1
  1. v0.1.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分