使用说明
MCP服务器
这个项目是一个MCP(模型上下文协议)服务器,在Node.js中实现了TypeScript。
如何运行
- 安装依赖关系 :
npm install - 编译工程 :
npm run build - 启动服务器 :
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:使用官方网站
- 访问 : https://inspector.modelcontextprotocol.org/
- 在连接字段中,输入您的服务器端点,例如:
http://localhost:3000/mcp - 单击连接以访问可视化界面。
选项 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的自动翻译或 此链接已翻译 获取葡萄牙语文档。
来源和参考资料
- 使用TypeScript构建您的第一个MCP服务器(黑客团队)
- Copilot开发者营
- 模型上下文协议TypeScript SDK
- 剧作家MCP
- 在Copilot Studio中引入模型上下文协议(MCP):简化与AI应用程序和代理的集成(微软博客)
- 我的第一台mcp服务器(Yusuke Wada)
关于作者
林肯·洛佩斯 (GitHub:林肯论坛)
- 来自巴西的开发者
- 电子邮件:lincolnlopes@msn.com
- 主要技能:TypeScript、JavaScript、Node.js。NET、Docker、React、SQL、Git
