服务器开发

人工智能 社区

技能解读

当前原文的自动摘译,尚未人工审校。

什么是 MCP 服务器

MCP 服务器是一个通过模型上下文协议公开一个或多个工具(以及可选的资源和提示)的进程。服务器通过 stdio 传输进行通信——它们从 stdin 读取 JSON-RPC 并将响应写入 stdout。 MCP 服务器是您打包和分发工具功能的方式。 LLM 客户端(Claude Code、Claude Desktop 等)启动服务器进程并调用其工具。

何时创建服务器

您有 2 个以上共享配置、状态或域的相关工具 您想要分发工具供其他人使用(通过 uvx 或 npx) 工具需要共享资源(数据库连接、API 客户端、身份验证令牌) 您正在构建特定于域的工具包(GitHub、数据库、监控等)

何时不创建服务器

单一实用工具 — 使用独立的工具文件(参见mcp-tool-dev技能) Claude Code 代理、技能或命令 — 使用各自的创建技能 REST API — MCP 用于 LLM 工具调用,而不是一般的 HTTP 服务

Python 与 TypeScript

因素 · Python (FastMCP) · TypeScript (@modelcontextprotocol/sdk) 分发 · uvx(uv 工具) · npx 类型系统 · 类型提示 + 文档字符串 · Zod 模式 打包 · pyproject.toml · package.json 带 bin 异步 · 本机 async/await · 本机 async/await

流狐档案 运行与权限由流狐静态检查推断,不代表作者声明或实际测试结果。
领域
人工智能
作者声明的智能体
未找到明确声明;不据此推断已兼容或已测试
静态检查
88 / 100 · 启发式扫描,不代表运行安全
运行环境证据
未执行;当前没有隔离运行测试证据
作者 / 版本 / 许可证
@tomevault-io · 未声明许可证
上下文用量评级
低消耗
接入复杂程度
需简单配置
是否需要外部接口密钥
不需要
兼容的系统
macOS · Linux · Windows
运行环境要求
Node.js · Python
检测到的文件与系统行为
  • 只读
  • 允许写入 / 修改
网络行为
仅限本地
安装命令数
无(仅作为资料)

需要注意: 未声明工具权限范围;实际权限由运行环境决定。

01
第 1 步:设计你的工具

列出每个工具及其名称、描述、参数和返回格式。应用整合原则:比起众多狭窄的工具,更喜欢功能较少的工具。对于每个工具,写下 3-4 句话的描述(什么、何时使用、何时不使用、行为注释)。这是最重要的一步——良好的描述可以防止误用。

02
第 2 步:搭建项目框架

使用模板作为起点: Python:`templates/mcp-server-python-template/` TypeScript:`templates/mcp-server-typescript-template/` 核心目录结构:Python:

03
第三步:实施工具

按照特定于语言的参考中的模式编写每个工具处理程序: Python:`references/python-server-patterns.md` TypeScript:`references/typescript-server-patterns.md` 所有工具的关键原则:验证每个处理程序顶部的输入

04
第 4 步:配置打包

Python (uvx): 在 `pyproject.toml` 中设置 `[project.scripts]`: TypeScript (npx): 在 `package.json` 中设置 `bin`:

05
第 5 步:处理服务器生命周期

实现正常关闭(SIGINT/SIGTERM 处理)。当客户端断开连接时,这对于干净的进程终止至关重要。

06
第 6 步:编写测试

分三个级别进行测试: 单元:导入处理程序、使用 dict 调用、断言输出 集成:启动服务器、通过 MCP 客户端调用工具 模式验证:验证工具定义与预期模式匹配 请参阅`references/server-testing-guide.md` 了解详细模式。

讨论

基于 GitHub Discussions。登录 GitHub 即可参与讨论、点赞、订阅更新。