Model Context Protocol

MCP 接入

小禾笔记提供了一个 MCP Server 端点，让 Claude、Cursor 等支持 MCP 的 AI 客户端可以直接搜索并读取站内的导航与博客内容。

服务端点

采用 Streamable HTTP 传输，端点地址为：

https://www.codeemo.cn/api/mcp

客户端配置

在支持 MCP 的客户端配置文件中添加（以 HTTP 传输为例）：

{
  "mcpServers": {
    "小禾笔记": {
      "type": "http",
      "url": "https://www.codeemo.cn/api/mcp"
    }
  }
}

可用工具

search

搜索导航与博客，按语义或关键词匹配。只需传入描述你想找什么的查询词即可。

参数	类型	必填	说明
`query`	`string`	是	想查找的内容
`limit`	`number`	否	返回条数 1-50，默认 20

get_detail

获取单条导航或博客的完整详情，包含正文内容、分类与时间。通常在 search 之后按 type + uuid 调用。

参数	类型	必填	说明
`type`	`"navigation" \| "blog"`	是	资源类型
`uuid`	`string`	是	资源 uuid（博客也可用 slug）

调用示例

通过 curl 调用 search 工具：

curl -X POST https://www.codeemo.cn/api/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "search",
      "arguments": { "query": "AI 工具", "limit": 5 }
    }
  }'