辅助MCP服务器
一个用于部署与OpenAI Apps SDK兼容的模型上下文协议(MCP)服务器的框架项目。该服务器使用官方(工具/库)提供了基本的实现 @modelcontextprotocol/sdk 使用TypeScript和Node.js构建的库。
概述
模型上下文协议(MCP)是一种开放规范,用于将大型语言模型客户端连接到外部工具、数据和用户界面。此框架提供了一个最小化的MCP服务器,其功能包括:
- 列出工具 – 宣传可用工具及其JSON Schema合约
- 呼叫工具 – 执行来自模型的工具请求
- 返回结构化内容 – 发送格式化的响应
先决条件
- Node.js 18及以上版本
- 使用 npm、yarn 或 pnpm 进行依赖管理
安装
克隆仓库并安装依赖项:
npm install或者使用 pnpm:
pnpm install用法
启动MCP服务器:
npm start服务器将在8000端口(或指定端口)上启动 PORT 环境变量) 并暴露:
- SSE流:
GET http://localhost:8000/mcp - 消息端点:
POST http://localhost:8000/mcp/messages?sessionId=...
项目结构
assistender-mcp-server/
├── src/
│ └── server.ts # Main MCP server implementation
├── package.json # Dependencies and scripts
├── tsconfig.json # TypeScript configuration
├── .gitignore # Git ignore rules
└── README.md # This file添加自定义工具
要添加自己的工具,请修改 src/server.ts:
- 在(此处)定义您的工具架构
tools数组 - 在(某处)添加一个处理程序
CallToolRequestSchema请求处理程序 - 返回符合您工具输出格式的结构化内容
示例:
const tools: Tool[] = [
{
name: "my-custom-tool",
description: "Description of what this tool does",
inputSchema: {
type: "object",
properties: {
param1: {
type: "string",
description: "Parameter description",
},
},
required: ["param1"],
},
},
];OpenAI Apps SDK 集成
此MCP服务器遵循OpenAI Apps SDK规范,并且可以与ChatGPT开发者模式集成。该服务器采用服务器发送事件(SSE)传输方式,使其能够兼容MCP检查器和ChatGPT连接器。
如需更多信息,请参阅:
发展
该项目采用:
- TypeScript 为了类型安全
- tsx(在编程或技术语境中,通常指“TypeScript XML”或特定于某种开发环境/框架的扩展名,但直接翻译无具体含义,保持原样) 用于直接运行TypeScript
- 佐德 用于运行时模式验证
- @modelcontextprotocol/sdk(注:这个名称在中文中没有直接的对应翻译,因为它是一个特定的技术或开发框架名称,保持原样即可,但为了理解其含义,可以解释为“ModelContextProtocol的SDK(软件开发工具包)”) 用于MCP(多路复用器/控制器/某种特定系统或协议,具体根据上下文确定)的实现
许可证
麻省理工学院(MIT)
