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 或 yarn
• OpenAI API 密钥

安装

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

npm install

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

cp .env.example .env

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

OPENAI_API_KEY=your_openai_api_key_here

运行服务器

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

npm start

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

npm run dev

与 Augment 一起使用

要将此 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-turbo, gpt-4)
• messages: 对话消息数组
• temperature: 控制随机性 (0-1)
• max_tokens: 要生成的最大 token 数

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，获取可以对此实现进行的潜在改进的列表。

许可证

MIT