MCP Server

MCP 服务

这是一个使用 TypeScript 在 Node.js 中实现的 MCP（Model Context Protocol）服务。

如何运行

1. 安装依赖：

   npm install
   

2. 编译项目：

   npm run build
   

3. 启动服务：

   npm start
   

服务将在 http://localhost:3000/ 上运行。

主要端点

• POST /mcp：MCP 请求的主要端点。
• GET /：服务状态消息。

开发

• 源代码位于 src/。
• 生成的构建文件将放入 dist/。
• 服务使用 Express 和 Model Context Protocol 官方 SDK。

检查工具

若要测试和检查你的 MCP 服务，请使用 MCP Inspector 官方工具。

如何使用 MCP Inspector

MCP Inspector 不会嵌入你的 MCP 服务中运行。它是一种外部工具，用于通过 HTTP 连接到你的 MCP 端点，就像 Postman 或 Insomnia 一样，但原生支持 MCP 协议。

选项 1：使用官方网站

• 访问：https://inspector.modelcontextprotocol.org/
• 在连接字段中输入你的服务端点，例如：http://localhost:3000/mcp
• 点击连接以打开可视化界面。

选项 2：在本地运行

• 在终端中执行：

  npx @modelcontextprotocol/inspector http://localhost:3000/mcp
  

• 这将在浏览器中打开 Inspector 界面（通常位于 http://localhost:6274）。

注意事项

• Inspector 始终是外部客户端，而不是服务的插件。
• 请勿直接通过浏览器访问 /mcp，因为浏览器会发送 GET 请求，而该端点需要 POST 请求。
• Inspector 会正确发送 POST 请求，并在友好的界面中显示所有内容。
• 如果服务运行在远程服务器上，请确保在防火墙中开放 3000 端口。

修复和详细信息

有关问题和已应用修复的详情，请参阅 fixes/ 文件夹，特别是 fixes/20250505-errorcode.md 文件，了解 ErrorCode 的情况及其解决方法。

官方文档（替代方案）

如需了解更多详情，请参阅官方文档（英文，可使用浏览器自动翻译）：

• Model Context Protocol 官方文档

也可以使用 Google Chrome 的自动翻译功能，或访问此翻译链接，查看葡萄牙语文档。

来源和参考资料

• 使用 TypeScript 构建你的第一个 MCP 服务（Hackteam）
• Copilot Developer Camp
• Model Context Protocol TypeScript SDK
• Playwright MCP
• 在 Copilot Studio 中引入 Model Context Protocol（MCP）：简化与 AI 应用和 Agent 的集成（Microsoft Blog）
• my-first-mcp-server（Yusuke Wada）

关于作者

Lincoln Lopes（GitHub：lincolnlopes）

• 来自巴西的开发者
• 电子邮件：[email protected]
• 主要技能：TypeScript、JavaScript、Node.js、.NET、Docker、React、SQL、Git