跳到主要内容

动手写一个只读 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,两条链路分别验证后再组合。