用 MCP 接上这座知识图谱

这个站点的知识图谱开放了一个只读 MCP server，任何支持 streamable HTTP 的 MCP 客户端都能直接连，不用申请密钥。它只返回公开层内容：你的智能体能搜概念、调阅单一概念页、拉整张图谱、问有依据的问题。

端点与协议

POST https://api.paulkuo.tw/mcp

只接受 POST 的 JSON-RPC 2.0 请求（其他方法返回 405），stateless streamable HTTP、不支持批量请求、无需认证。浏览器端网页受 Origin 白名单限制，请从智能体或服务器端调用。

挂载方式

Claude Code 一行命令：

claude mcp add --transport http paulkuo-wiki https://api.paulkuo.tw/mcp

或先用 curl 试一发：

curl -s https://api.paulkuo.tw/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"wiki_search","arguments":{"query":"AI"}}}'

其他支持 streamable HTTP 的 MCP 客户端，填入上方端点即可。

四个工具

工具	做什么	范围与限制
`wiki_search`	关键词搜索公开概念页（匹配标题、标签、摘要），返回相符页面与摘录。	只索引公开 concept 页，不含 sources 原文与文章全文。
`wiki_get_concept`	用 slug 调出单一公开概念页全文（frontmatter 加正文）；slug 可从 wiki_search 结果或 wiki_ask 回答的 [[slug]] 引用获取。	只接受小写字母、数字与连字符组成的 slug；非公开或不存在的 slug 返回 404 式错误。
`wiki_graph`	拉取整张公开知识图谱：节点（id／标题／类型／支柱）与无向边。	无参数，一次返回整张图，响应较大。
`wiki_ask`	有依据的问答：检索公开 wiki 内容后作答，引用以 [[slug]] 标记。	问题上限 500 字；检索不到依据就会拒答，不硬编。这是唯一消耗 AI 推理成本的工具，每日有总额度。

可见性红线

四个工具都只读公开层。内部笔记、未公开素材与去标识化后仍属私人领域的内容，不在这个 server 的世界里。

限流

/mcp 端点约每分钟 30 次请求；工具调用约每分钟 10 次；wiki_ask 另有每分钟 5 次与每 IP 每日 30 次的额度，全站每日预算用完返回 503。每分钟限流是尽力而为的内存计数；每日额度与全站预算以计数器存放、24 小时后自动删除。数字可能调整。

提问记录

wiki_ask 的提问文字会写入站方日志，用于观察问题类型、改进检索，90 天后自动删除。写入前会按常见格式屏蔽 email、台湾手机号与固定电话号码、台湾身份证号格式与 9 位以上的连续数字；其他写法或其他个人信息不保证会被屏蔽，请勿在提问中输入。提问记录本身不含 IP 与浏览器信息；每日提问额度另按 IP 计数，24 小时后自动删除。

回答语言

wiki 内容与 wiki_ask 的回答以繁体中文为主。wiki_search 比对的是繁中语料的标题与标签，中文关键词命中率最高；英文词只在原文本身含该词（如 AI、MCP）时才会命中，跨语言的问题交给 wiki_ask。

/ask 别名

同一个问答能力也有 NLWeb 风格的 HTTP 别名（GET／POST https://api.paulkuo.tw/ask），适合不想走 MCP 的简单集成；「NLWeb 风格」说的是接口形状，不是合规声明。

与页面内置 WebMCP 的区别

网站页面另外内置了 client-side 的 WebMCP 工具（/.well-known/mcp.json），那是浏览器里的另一套东西；本页说的是服务器端的 MCP endpoint，两者互不相干。