MCP协议服务器

一个基于Node.js和TypeScript实现的Model Context Protocol(MCP)服务器,提供MCP协议的端点服务,适用于AI应用和代理的简化集成。

  • by lincolnlopes
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 lincolnlopes/mcp-server

使用说明

MCP服务器

这个项目是一个MCP(模型上下文协议)服务器,在Node.js中实现了TypeScript。

如何运行

  1. 安装依赖关系 :
    npm install
    
  2. 编译工程 :
    npm run build
    
  3. 启动服务器 :
    npm start
    

服务器将可在 http://localhost:3000/.

端点原理

  • POST /mcpMCP 请求的主要终端。
  • GET /服务器状态消息 。

开发

  • 源代码在 src/.
  • 生成的构建将转到 dist/.
  • 该服务器使用 Express 和官方的 Model Context Protocol SDK。

检测工具

要测试和检查您的 MCP 服务器,请使用 MCP官方检查员.

如何使用 MCP Inspector

O MCP检查员 未在您的 MCP 服务器内嵌运行它是一个外部工具,旨在通过HTTP连接到您的MCP终端,就像Postman或Insomnia一样,但本地支持MCP协议。

选项1:使用官方网站

选项 2: 本地旋转

  • 不执行终端:
    npx @modelcontextprotocol/inspector http://localhost:3000/mcp
    
  • 这将在浏览器中打开检查器界面(通常在http://localhost:6274 )。

评论

  • Inspector 始终是一个外部客户端,而不是您的服务器插件。
  • 不要尝试登录 /mcp 直接通过浏览器,因为它执行GET,终端点等待POST。
  • 检查器正确执行POST请求,并在友好的界面中显示所有内容。
  • 如果在远程服务器上运行,请确保在防火墙上释放端口3000。

修复和详细信息

有关应用的问题和修补程序的详细信息,请参阅文件夹 fixes/尤其是档案 fixes/20250505-errorcode.md 为了理解案例 ErrorCode 以及如何解决。

正式文件(备选)

有关详细信息,请参阅官方文档(英文,浏览器可自动翻译):

或者使用Google Chrome的自动翻译或 此链接已翻译 获取葡萄牙语文档。

来源和参考资料

关于作者

林肯·洛佩斯 (GitHub:林肯论坛)

  • 来自巴西的开发者
  • 电子邮件:lincolnlopes@msn.com
  • 主要技能:TypeScript、JavaScript、Node.js。NET、Docker、React、SQL、Git