MCP Openai Server (Marchampson)

OpenAI MCP服务器

用于OpenAI API的模型上下文协议（MCP）服务器实现。该服务器使用官方的MCP SDK在Augment和OpenAI的语言模型之间提供了一个标准化的接口。

什么是MCP？

模型上下文协议（MCP）是一个标准化的API规范，它提供了与各种大型语言模型（LLM）交互的统一方式。它允许像Augment这样的应用程序通过一致的接口与不同的LLM提供商协同工作。

MCP充当LLM的“通用适配器”，它将应用程序请求转换为每个LLM提供者所需的特定格式。

特性

• 🔄 使用官方MCP SDK进行兼容性
• 安全的API密钥管理
• 📊 支持聊天完成
• 📋 模型列表
• 🧠 嵌入生成
• ⚠️ 正确的错误处理和记录

先决条件

• Node.js（v16或更高版本）
• npm或纱线
• OpenAI API密钥

安装

1. 克隆此存储库或将文件复制到项目目录
2. 安装依赖项：

npm install

1. 创建一个 .env 文件基于 .env.example 提供：

cp .env.example .env

1. 将您的OpenAI API密钥添加到 .env 文件：

OPENAI_API_KEY=your_openai_api_key_here

运行服务器

使用以下命令启动服务器：

npm start

对于在文件更改时自动重启的开发：

npm run dev

使用增强

要将此MCP服务器与Augment一起使用，请将以下内容添加到Augment settings.json文件中：

"augment.advanced": {
    "mcpServers": [
        {
            "name": "openai-mcp",
            "command": "node",
            "args": ["/path/to/openai-mcp-server.js"],
            "env": {
                "OPENAI_API_KEY": "your_openai_api_key_here",
                "DEBUG": "true"
            }
        }
    ]
}

替换 /path/to/openai-mcp-server.js 使用系统上服务器文件的实际路径。

可用工具

此MCP服务器为Augment提供以下工具：

1.列出型号

列出所有可用的OpenAI模型。

2.聊天完成

使用OpenAI的聊天完成API生成响应。支持以下参数：

• model：要使用的型号（例如gpt-3.5涡轮增压、gpt-4）
• messages：对话消息数组
• temperature：控制随机性（0-1）
• max_tokens：要生成的最大令牌数

3.创建嵌入

使用OpenAI的嵌入API为文本生成嵌入。支持以下参数：

• model：要使用的模型（例如text-embedding-ada-002）
• input：要嵌入的文本（字符串或字符串数组）

测试

示例客户端提供在 client-example.js 测试您的MCP服务器。运行它：

node client-example.js

理解代码

服务器由几个关键组件组成：

1. MCP SDK集成：使用官方MCP SDK进行标准化通信
2. 工具操作员：为每个支持的工具实现处理程序
3. OpenAI API集成：与OpenAI的API通信
4. 错误处理：提供一致的错误响应
5. 日志记录：记录调试操作

潜在改进

看 mcp-server-improvement-suggestions.md 以获取可以对此实现进行的潜在改进的列表。

许可证

麻省理工学院