🚀 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 许可证。
