MCP 接口接入指南 · 生物传感器知识库

1先拿一个令牌

接口需要 Bearer 令牌鉴权。登录后到令牌中心生成，可以指定有效期，也能随时停用或删除。

令牌只在生成时完整显示一次，之后列表里只看得到前后几位。当场复制保存；丢了就删掉重新生成。

2Claude Code CLI

一条命令加完，无需手写配置文件。把 <令牌> 换成你自己的。

claude mcp add --transport http biosensor-kb \
  https://biosensor.mtc-lab.cn/mcp/ \
  --header "Authorization: Bearer <令牌>"

默认只对当前目录生效。想全局可用加 -s user，想随项目提交给同事加 -s project（会写进项目根目录的 .mcp.json）。

确认挂上了

claude mcp list

列表里出现 biosensor-kb 且状态正常即可。之后直接问模型「查一下适配体检测多巴胺的传感器，灵敏度多少」，它会自己调工具。

3Kimi CLI

Kimi Code 读两个位置的 mcp.json：全局的 ~/.kimi-code/mcp.json，和当前目录下的 .kimi-code/mcp.json。任选其一写入：

{
  "mcpServers": {
    "biosensor-kb": {
      "transport": "http",
      "url": "https://biosensor.mtc-lab.cn/mcp/",
      "headers": { "Authorization": "Bearer <令牌>" }
    }
  }
}

Kimi 的 transport 只认 http / sse / stdio 三个值，本接口用 http。
它也会直接读取项目根目录的 .mcp.json（与 Claude Code 同格式），所以上一步用 -s project 加过的话，Kimi 这边不用再配。

改完配置需要新开一个会话（/new）或重启 Kimi 才会加载。交互式配置也可以用内置的 /mcp-config。

4其他客户端

DeepSeek harness、WorkBuddy 以及大多数支持 MCP 的客户端，接入所需的信息就三项：

参数	值
传输方式	HTTP（Streamable HTTP / JSON-RPC over POST）
服务地址	https://biosensor.mtc-lab.cn/mcp/
请求头	Authorization: Bearer <令牌>

绝大多数客户端用的都是下面这套通用 JSON，只是文件位置不同：

{
  "mcpServers": {
    "biosensor-kb": {
      "type": "http",
      "url": "https://biosensor.mtc-lab.cn/mcp/",
      "headers": { "Authorization": "Bearer <令牌>" }
    }
  }
}

上面 Claude Code 和 Kimi 两节的写法是在本机实测确认过的；DeepSeek harness 与 WorkBuddy 的配置文件路径没在本机验证，请以各自文档为准——但需要填的三项参数是一样的。

可用工具

挂上之后，模型能看到三个工具：

工具	作用	参数
search_biosensor_papers	检索文献，返回题目、DOI、期刊、年份、传感器类型、检测对象、灵敏度、原文链接	query、sensor_type、analyte、year、limit、offset
get_biosensor_paper	取一篇的全部字段：中英文摘要、传感器构成、检测原理、灵敏度、效应效果、构成图示、原文 PDF	id 或 doi
biosensor_stats	库规模与各传感器类型的论文数分布	无

检索支持中英文混合，中文按二元分词匹配，所以「适配体」「外泌体」这类词能正常命中。

自检与排错

客户端挂不上时，先用 curl 确认接口和令牌本身没问题：

curl -s -X POST https://biosensor.mtc-lab.cn/mcp/ \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <令牌>" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

现象	原因
返回无效或已过期的令牌	令牌拼错、已过期，或在令牌中心被停用了
客户端列出服务但工具是空的	tools/list 也要带令牌；请求头没配上
配置写完没反应	MCP 配置一般在会话启动时加载，新开会话或重启客户端

用浏览器直接打开 /mcp/ 会返回一份服务描述（协议版本、工具名），可以用来确认服务活着。