OpenAI MCP 服务器

OpenAI MCP 服务器是一个为OpenAI API实现的模型上下文协议(MCP)服务器,提供标准化的接口,用于通过官方MCP SDK与OpenAI的语言模型进行交互。

  • by marchampson
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 marchampson/mcp-openai-server

使用说明

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

许可证

麻省理工学院