跳过主要内容

海棠诗社 · 开放接口

MCP 使用指南

MCP(Model Context Protocol)让 AI 助手直接查询海棠诗社的公开诗词库。你可以在对话里找诗句、读原文、查作者,不需要离开客户端。

MCP 服务器地址
https://haitang.app/mcp

传输方式:Streamable HTTP · 公开只读 · 无需登录或 API Key

1. 连接你的客户端

按你使用的客户端选一种方式。其他支持远程 MCP 的客户端可以直接填写上面的地址,选择 Streamable HTTP,认证留空。

Claude Code · 终端命令
claude mcp add --transport http haitang https://haitang.app/mcp
Codex CLI · 终端命令
codex mcp add haitang --url https://haitang.app/mcp
Cursor · mcp.json
{
  "mcpServers": {
    "haitang": {
      "url": "https://haitang.app/mcp"
    }
  }
}

在 Cursor 中,把配置保存到项目根目录的 .cursor/mcp.json,或保存到 ~/.cursor/mcp.json 供所有项目使用。如果文件已存在,把 haitang 条目合并到现有的 mcpServers 中,不用替换整个文件。添加后如果没看到工具,重新打开会话并检查 haitang 是否已启用。

2. 在对话中试用

示例提问
用海棠 MCP 搜索「床前明月光」,找到原诗,给出全文、作者和来源链接。

助手可以先调用 search_poetry 找到作品,再用返回的 ID 调用 get_work 读取原文。查作者资料用 get_author,按朝代或选集浏览作品用 list_works。

3. 用 curl 直接试调

不安装客户端也能试调。下面的请求会返回《静夜思》的摘要和作品链接。开发时可用 tools/list 查询全部工具和参数,再用 tools/call 调用。

curl · 搜索诗词
curl -sS https://haitang.app/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-03-26' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_poetry","arguments":{"query":"床前明月光","workLimit":3}}}'

在浏览器地址栏打开 /mcp 返回 405 是正常的:它是接受 JSON-RPC POST 的接口,不是网页。完整工具和参数请见 MCP 技术参考(Markdown)。