海棠诗社 · 开放接口
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/mcpCodex CLI · 终端命令
codex mcp add haitang --url https://haitang.app/mcpCursor · 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)。