MCP 服务器

本站在 https://oxphp.dev/mcp 运行一个公开的 Model Context Protocol(MCP)服务器。把编码智能体指向它,它就能读取你此刻正在阅读的这份文档——页面 slug、完整正文,以及环境变量参考——而不必猜测 API 名称,或依赖过时的训练数据。

连接

该端点使用 Streamable HTTP:只有一个 POST /mcp,不支持 stdio 传输。大多数客户端只需要这个 URL。

bash

claude mcp add --transport http oxphp-docs https://oxphp.dev/mcp

任何读取 mcpServers 配置块的客户端——Claude Desktop、Cursor 等——都接受同样的写法:

mcp.json

{
  "mcpServers": {
    "oxphp-docs": {
      "type": "http",
      "url": "https://oxphp.dev/mcp"
    }
  }
}

把下面这段话交给能够修改自身 MCP 配置的智能体,它会自己把服务器加上:

text

Add an MCP server named "oxphp-docs" to your configuration: transport HTTP
(Streamable HTTP), URL https://oxphp.dev/mcp, no authentication. It is a
public, read-only documentation server for OxPHP with three tools —
list_docs, read_doc and list_config. Use it whenever a question touches
OxPHP documentation or the name or default value of an environment
variable, instead of answering from memory.

**这个办法并非到处都行。**不少智能体能使用 MCP 服务器,却无法根据聊天里的一句话把它写进自己的配置——有的会直说做不到,有的则声称加好了,而工具列表里什么也没出现。

工具

三个工具,全部只读:

工具	参数	说明
`list_docs`	`locale`(可选,默认 `en`)	列出每一篇 OxPHP 文档页面:slug、标题和描述。先调用它,了解 `read_doc` 接受哪些 slug。
`read_doc`	`slug`(必填),`locale`(可选,默认 `en`)	按 slug 返回一篇 OxPHP 文档页面的完整 Markdown,文中链接已改写为站内绝对地址。
`list_config`	`locale`(可选,默认 `en`)	列出每个 OxPHP 环境变量及其默认值和描述,按类别分组。用它来代替猜测配置键名。

locale 接受 en、ru、zh、fr、pl 或 ja;其他值一律回退到 en。slug 就是 list_docs 条目给出的准确字符串,例如 getting-started/quick-start。

Note

read_doc 不会附带本页 .md 孪生版所带的索引脚注——要浏览语料库的其余部分,请改用 list_docs。

只读且匿名

这个服务器不写入任何东西,也不会自行调用模型——它只提供本站已经公开的 Markdown 与配置数据。不需要 API 密钥,也不需要登录:每个请求都是匿名的。会话只保存协议握手的状态,不与任何身份关联,并在最后一次调用的 15 分钟后被丢弃。

限流

请求按 IP 地址限流:每 5 分钟 120 次,每天 2000 次。典型的一次智能体会话——一次 list_docs 加上几次 read_doc——只会用掉这个额度的一小部分。超出限制后,调用会返回错误而不是结果,直到限流窗口重置。