动手写一个只读 MCP Server
这个实验暴露三条公开的教学笔记,验证工具发现、调用、错误与资源读取。数据固定在代码中,不读取个人文件、不访问数据库,也不需要模型账号。
实验结构
示例使用官方 Python SDK v1 接口,验证时使用 mcp==1.30.0。官方 SDK v1 文档
准备实验环境
在实验目录创建虚拟环境并安装示例所用的 SDK 版本。
python3 -m venv .venv
source .venv/bin/activate
python -m pip install 'mcp==1.30.0'
建议使用 Python 3.10 或以上。把下面的代码保存为 server.py,将客户端的 stdio 启动命令设为虚拟环境中的 Python 解释器,参数设为 server.py 的路径。
服务端核心代码
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("BoomLee Notes Lab")
NOTES = {"mcp": "MCP 连接应用与外部工具、资源和提示模板。"}
@mcp.tool()
def find_note(query: str) -> dict:
query = query.strip().lower()
if not query or len(query) > 100:
raise ValueError("query must contain 1 to 100 characters")
return {"items": [{"id": key, "text": text}
for key, text in NOTES.items()
if query in key or query in text.lower()]}
@mcp.resource("note://{note_id}")
def read_note(note_id: str) -> str:
if note_id not in NOTES:
raise ValueError("unknown note id")
return NOTES[note_id]
if __name__ == "__main__":
mcp.run(transport="stdio")
示例使用忽略大小写的子串匹配。可以先用它检查协议连接,再替换业务检索层。
检查客户端究竟验证了什么
| 检查 | 预期 |
|---|---|
| 列出工具 | 包含 find_note |
搜索 MCP | 返回 mcp 教学笔记 |
| 查询不存在的主题 | 正常返回空列表 |
| 查询全是空白 | 工具返回错误 |
读取 note://mcp | 得到资源正文 |
| 读取未知笔记 | 资源读取失败 |
用支持 stdio 的 MCP 客户端按表逐项验证。接入模型后,再观察它是否在合适的时机选择工具。
接入真实应用前补什么
stdio 的普通日志写到 stderr;将来替换成真实资料库时,应增加用户身份、访问范围、分页、结果大小和上游超时。远程传输的身份与来源校验应按所用协议版本实施,不能直接沿用本地子进程的假设。传输规范
接入模型的下一步见 Function Calling,两条链路分别验证后再组合。