{
  "protocolVersion": "2025-06-18",
  "capabilities": {
    "tools": {}
  },
  "serverInfo": {
    "name": "jcyyzx-regulation",
    "version": "4.2.1"
  },
  "instructions": "jcyyzx.com MCP Server - 提供文章搜索、分类浏览、法规清单查询服务。支持Streamable HTTP传输（JSON + SSE流式）。只读查询，无写入权限。鉴权兼容 X-API-Key 与 Authorization: Bearer 两种标准头。",
  "endpoints": {
    "mcp": "https://jcyyzx.com/mcp",
    "sse": "https://jcyyzx.com/sse",
    "health": "https://jcyyzx.com/mcp/health"
  },
  "transport": {
    "type": "streamable-http",
    "modes": ["json", "sse"],
    "description": "支持同步JSON响应和SSE流式响应；会话头使用标准 Mcp-Session-Id"
  },
  "authentication": {
    "type": "header",
    "header": "X-API-Key",
    "publicKey": "jcyyzx_public_mcp_2026",
    "altHeader": "Authorization: Bearer <key>",
    "description": "公开只读key，限频20次/分钟（nginx）+100次/分钟（应用层）。支持工具：get_site_info, get_categories, list_articles, get_article, search_articles, search_content, get_regulation_index, get_regulation_detail"
  },
  "auth_hint": {
    "supported": ["X-API-Key header", "Authorization: Bearer <key>"],
    "not_supported": ["?key= query parameter"],
    "why": "查询参数方式不被接受；若 401 请改用请求头。",
    "discovery": "GET https://jcyyzx.com/mcp 直接返回完整工具清单与鉴权说明",
    "unauthorized_response": "401 响应体会带 hint 字段，指向本文档与公开 key"
  },
  "quickstart": {
    "list_tools": "curl -s -X POST https://jcyyzx.com/mcp -H 'X-API-Key: jcyyzx_public_mcp_2026' -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'",
    "call_tool": "curl -s -X POST https://jcyyzx.com/mcp -H 'X-API-Key: jcyyzx_public_mcp_2026' -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":2,\"method\":\"tools/call\",\"params\":{\"name\":\"get_site_info\",\"arguments\":{}}}'",
    "initialize": "curl -s -X POST https://jcyyzx.com/mcp -H 'X-API-Key: jcyyzx_public_mcp_2026' -H 'Content-Type: application/json' -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"initialize\",\"params\":{\"protocolVersion\":\"2024-11-05\",\"capabilities\":{},\"clientInfo\":{\"name\":\"client\",\"version\":\"1.0\"}}}'"
  },
  "capabilities_list": [
    "get_site_info - 获取站点基本信息、服务范围、主要分类导航",
    "get_categories - 分类目录树（只读）",
    "list_articles - 文章列表（只读）",
    "get_article - 文章详情（只读，支持 max_len 正文裁剪）",
    "search_articles - 标题/关键词搜索（只读）",
    "search_content - 正文全文搜索（只读）",
    "get_regulation_index - 法规清单（只读）",
    "get_regulation_detail - 法规详情（只读）",
    "search_regulations - [兼容] 搜索法规（只读）",
    "get_regulation - [兼容] 获取法规（只读）",
    "list_categories - [兼容] 列出分类（只读）"
  ],
  "security": {
    "readonly": true,
    "write_access": false,
    "cors": "白名单来源 + Origin 校验（防 DNS rebinding）",
    "description": "所有工具均为只读查询，无数据库写入权限；对外公开只读知识库，CLI 管理工具不在此端点"
  }
}