Openai Sdk Knowledge Org

🚀 OpenAI SDK 知识 MCP 服务器（非官方）

这是一个对 OpenAI API 了如指掌的 MCP 服务器。它完全采用 TypeScript 构建，借助了 OpenAI Agents SDK、Hono、Cloudflare Workers 和 Drizzle ORM 的强大功能。由检索增强生成（RAG）技术提供支持，随时准备回答你的技术问题。

🚀 快速开始

本地运行

# 克隆项目并安装依赖
git clone https://github.com/seratch/openai-sdk-knowledge-org.git
cd openai-sdk-knowledge-org/
npm install

# 配置（添加你的 OpenAI API 密钥）
cp .dev.vars.example .dev.vars
# 编辑 .dev.vars: OPENAI_API_KEY=sk-your-key-here

# 运行项目
npm run dev

你可以访问 http://localhost:8787 查看其运行情况。

要求：Node.js 22+ 以及 API 密钥（OpenAI、GitHub）

✨ 主要特性

• Cloudflare 技术栈：充分利用 Cloudflare Workers、Queues、D1、Vectorize 和 AI Gateway。
• 可流式传输的 HTTP MPC 服务器：与任何 MPC 客户端兼容。
• ChatGPT 深度研究连接器：满足 ChatGPT 的深度研究连接器要求。
• 持续更新：持续从 OpenAI 仓库和社区论坛获取新内容。
• 借助 AI 快速构建：与各种 AI 编码工具协同开发。

📦 安装指南

你可以按照以下步骤在本地安装和运行此项目：

# 克隆项目并安装依赖
git clone https://github.com/seratch/openai-sdk-knowledge-org.git
cd openai-sdk-knowledge-org/
npm install

# 配置（添加你的 OpenAI API 密钥）
cp .dev.vars.example .dev.vars
# 编辑 .dev.vars: OPENAI_API_KEY=sk-your-key-here

# 运行项目
npm run dev

💻 使用示例

可流式传输的 HTTP MCP 服务器

使用可公开访问的 URL（例如 ngrok、Cloudflare Tunnel）为 MCP 客户端提供端点服务。你可以在首页生成令牌：

{
  "mcpServers": {
    "openai-sdk-knowledge.org": {
      "type": "streamable-http",
      "url": "https://openai-sdk-knowledge.org/mcp",
      "headers": {
        "Authorization": "Bearer {your api key here}"
      }
    }
  }
}

例如，你可以将此 MCP 服务器添加到 Cursor 中：

不仅是 Cursor，你还可以将此 MCP 服务器与任何支持 MCP 服务器连接的工具一起使用。

OpenAI 响应 API 的托管 MCP 服务器工具

你可以传递 https://openai-sdk-knowledge.org/mcp 以及有效的 API 令牌：

然后，你可以在与响应 API 代理的对话中调用此工具：

ChatGPT 深度研究 MCP 连接器

此外，对于 ChatGPT 深度研究客户连接器，使用相同的 URL。当 ChatGPT 服务器访问此应用的 MCP 服务器端点时，它还会返回 search 和 fetch 工具（详情请参阅 文档）。

🔧 技术细节

此应用本质上是一个运行在 Cloudflare Workers 上的简单 Web 应用。该 Web 应用提供与 MCP 服务器协议兼容的端点，以及一个 Web 用户界面。对于 RAG 数据管道，它从数据源收集数据并生成异步任务，将其排入 Cloudflare 的队列中。

src/
├── agents/          # 使用 OpenAI Agents SDK 构建的内部使用的代理
├── pipeline/        # RAG 数据收集和处理
├── server/mcp/      # MCP 协议实现
├── server/web/      # Web 应用实现
├── storage/         # 向量数据库（Vectorize）和 D1 数据库访问
└── index.ts         # 应用入口点

📄 许可证

本项目采用 MIT 许可证。