模型上下文协议服务器

TypeScript MCP示例服务器

这个项目展示了一个最小 模型上下文协议（MCP） 使用TypeScript实现服务器，使用官方 TypeScript SDK.它为工具调用和资源访问提供了一个简单的API，并与用于测试和探索的MCP Inspector兼容。

特性

• 添加工具：通过MCP协议添加两个数字。
• 问候资源：为任何名字生成动态问候语。
• 可流式HTTP传输：使用MCP推荐的HTTP传输。
• Express.js集成：易于扩展且熟悉的web服务器设置。

npm安装@modelcontextprotocol/sdk-expresszod@3 npx-y tsx服务器.ts npx@modelcontextprotocol/检查器

入门指南

1.安装依赖项

npm install @modelcontextprotocol/sdk express zod@3

2.运行服务器

npx -y tsx server.ts

服务器将于启动 http://localhost:3000/mcp.

3.使用MCP检验员进行测试

您可以使用官方的MCP检查器与此服务器进行交互：

npx @modelcontextprotocol/inspector

检查器设置：

• 运输类型： 流式HTTP
• 网址： http://localhost:3000/mcp
• 连接类型： 通过代理

API概述

工具

• 添加：将两个数字相加。
  • 输入： { "a": number, "b": number }
  • 输出： { "result": number }

资源

• 问候语：//{姓名}：返回给定名字的问候语。
  • 例子： greeting://Alice → Hello, Alice!

项目结构

• server.ts --主服务器实现
• package.json --项目依赖关系
• README.md --本文件

故障排除

• 确保已安装Node.js 18+。
• 如果您看到端口冲突，请在中更改端口 server.ts 或设置 PORT 环境变量。
• 有关MCP检查器问题，请参阅 MCP检查员文件.

许可证

麻省理工学院（见 许可证 如果存在）