MCP / Skill 服务接入说明

本文档用于将本站能力接入到其它 AI 平台（如支持 MCP 的客户端、自动化流程平台）。

1. 服务地址

• MCP 服务：/api/mcp

• Skill 服务：/api/skills

完整地址示例：

• https://你的域名/api/mcp

• https://你的域名/api/skills

2. 鉴权方式

• 在后台「系统设置」中可配置 mcp.service.token

• 配置后，推荐在请求头携带：

x-mcp-token: <你的token>

兼容方式（可选）：

Authorization: Bearer <你的token>

说明：mcp.service.token 仅用于 /api/mcp 与 /api/skills，与站点后台管理登录令牌是独立体系，不会共享或覆盖。

3. MCP 支持工具

search_articles

• 作用：搜索站内文章

• 参数：

  • query（必填）

  • limit（可选，1-50）

search_shuoshuo

• 作用：搜索说说内容

• 参数：

  • query（必填）

  • pageSize（可选，1-50）

get_site_stats

• 作用：获取站点浏览量统计

• 参数：无

ask_super_agent

• 作用：调用站点超级智能体

• 参数：

  • question（必填）

  • mode（可选，chat / search / execute）

    • chat：常规问答

    • search：偏检索式回答

    • execute：允许进入动作执行路径（受权限与安全确认策略限制）

4. MCP 调用示例

列出工具：

curl -X POST "https://你的域名/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{"method":"tools/list"}'

调用工具：

curl -X POST "https://你的域名/api/mcp" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <token>" \
  -d '{
    "method":"tools/call",
    "params":{
      "name":"search_articles",
      "arguments":{"query":"Next.js", "limit":5}
    }
  }'

5. Skill 拉取示例

curl "https://你的域名/api/skills" \
  -H "Authorization: Bearer <token>"

返回内容包含技能列表，外部 AI 可以将其拼接为系统提示词或工具策略。