怎么写一个最小 MCP 服务器

先暴露两三个只读工具,再谈框架、远程和鉴权。

MCP 服务器是进程:声明工具名、参数 schema、返回文本或结构化结果。官方文档有 TypeScript 与 Python SDK,社区也有 FastMCP 一类封装。

最小可行:一个 ping 工具加一个只读查询。stdio 最容易接到 Cursor 或 Claude Desktop。先让客户端显示已连接,再加写操作。

工具描述要短,参数用明确类型。返回值控制体积,避免把整份日志塞进上下文。错误用可读字符串,不要只抛栈。

本站目录只收录已有公开项目。自己写的服务器先在本地验证,再决定是否公开仓库。对照“MCP 安全入门”收窄路径和密钥。