Gpt5mcp

🚀 GPT-5 MCP 服务器

这是一个模型上下文协议（MCP）服务器，可通过 Claude Code 与 OpenAI 的 GPT-5 API 实现无缝集成。借助该服务器，你可以在 Claude Code 工作流程中直接利用 GPT-5 的强大功能。

🚀 主要特性

• 直接集成 GPT-5：通过简单提示或结构化对话调用 GPT-5 API。
• 两大强大工具：
  • gpt5_generate：使用提示进行简单文本生成。
  • gpt5_messages：使用消息数组处理结构化对话。
• 专为 Claude Code 打造：针对与 Anthropic 的 Claude Code IDE 无缝集成进行了优化。
• 支持 TypeScript：完全类型化，提供更优质的开发体验。
• 错误处理：具备强大的错误处理能力，并提供详细反馈。
• 使用情况跟踪：内置令牌使用报告功能。

📋 前提条件

• Node.js（v18 或更高版本）
• 具备 GPT-5 访问权限的 OpenAI API 密钥
• Claude Code IDE

📦 安装指南

1. 克隆仓库

git clone https://github.com/AllAboutAI-YT/gpt5mcp.git
cd gpt5mcp

2. 安装依赖

cd servers/gpt5-server
npm install

3. 构建服务器

npm run build

4. 配置环境变量

在 servers 目录下创建一个 .env 文件：

# servers/.env
OPENAI_API_KEY=your-openai-api-key-here

🔧 Claude Code 集成

将服务器添加到 Claude Code

claude mcp add gpt5-server -e OPENAI_API_KEY=your-openai-api-key-here -- node /path/to/gpt5mcp/servers/gpt5-server/build/index.js

验证安装

使用简单查询测试服务器：

Ask GPT-5: "Hello, how are you today?"

📚 可用工具

gpt5_generate

使用简单输入提示生成文本。 参数：

• input（必需）：提供给 GPT-5 的文本提示。
• model（可选）：GPT-5 模型变体（默认："gpt-5"）。
• instructions（可选）：模型的系统指令。
• reasoning_effort（可选）：推理级别（"low"、"medium"、"high"）。
• max_tokens（可选）：生成的最大令牌数。
• temperature（可选）：随机性级别（0 - 2）。
• top_p（可选）：Top-p 采样参数（0 - 1）。

gpt5_messages

使用结构化对话消息生成文本。 参数：

• messages（必需）：包含角色和内容的对话消息数组。
• model（可选）：GPT-5 模型变体（默认："gpt-5"）。
• instructions（可选）：模型的系统指令。
• reasoning_effort（可选）：推理级别（"low"、"medium"、"high"）。
• max_tokens（可选）：生成的最大令牌数。
• temperature（可选）：随机性级别（0 - 2）。
• top_p（可选）：Top-p 采样参数（0 - 1）。

消息格式：

{
  "messages": [
    {"role": "user", "content": "What is the capital of France?"},
    {"role": "assistant", "content": "The capital of France is Paris."},
    {"role": "user", "content": "What about Germany?"}
  ]
}

💻 使用示例

基础用法

// 使用 gpt5_generate 工具
{
  "input": "Explain quantum computing in simple terms",
  "reasoning_effort": "high",
  "max_tokens": 500
}

高级用法

// 使用 gpt5_messages 工具
{
  "messages": [
    {"role": "user", "content": "I'm learning Python. Can you help?"},
    {"role": "assistant", "content": "I'd be happy to help you learn Python! What specific topic would you like to start with?"},
    {"role": "user", "content": "Let's start with variables and data types."}
  ],
  "instructions": "Be a helpful Python tutor",
  "reasoning_effort": "medium"
}

📁 项目结构

gpt5mcp/
├── servers/
│   └── gpt5-server/
│       ├── src/
│       │   ├── index.ts          # 主服务器实现
│       │   └── utils.ts          # GPT-5 API 实用工具
│       ├── build/                # 编译后的 TypeScript 输出
│       ├── package.json          # 依赖项和脚本
│       └── tsconfig.json         # TypeScript 配置
├── CLAUDE.md                     # Claude Code 配置
├── GPT5-MCP-Server-Guide.html    # 交互式设置指南
├── .gitignore                    # Git 忽略规则
└── README.md                     # 本文件

🛡️ 安全措施

• API 密钥从环境变量加载（绝不硬编码）。
• .env 文件会自动从版本控制中排除。
• 所有 API 通信均使用安全的 HTTPS。
• 错误消息不会暴露敏感信息。

🔄 开发

脚本

• npm run build：编译 TypeScript 并设置权限。
• npm run start：启动编译后的服务器。
• npm run dev：在开发模式下构建并启动。

进行更改

1. 在 src/ 目录中编辑 TypeScript 文件。
2. 运行 npm run build 进行编译。
3. 如有需要，重启 Claude Code MCP 服务器。

🐛 故障排除

常见问题

Claude Code 中找不到服务器：

# 移除并重新添加服务器
claude mcp remove gpt5-server
claude mcp add gpt5-server -e OPENAI_API_KEY=your-key -- node /path/to/build/index.js

API 密钥问题：

• 确保你的 OpenAI API 密钥具备 GPT-5 访问权限。
• 验证密钥是否在 .env 文件中正确设置。
• 检查环境变量是否正确加载。

构建错误：

# 清理并重新构建
rm -rf build/
npm run build

📖 交互式指南

在浏览器中打开 GPT5-MCP-Server-Guide.html，可获取带有复制粘贴命令的交互式分步设置指南。

🤝 贡献

1. 分叉仓库。
2. 创建功能分支：git checkout -b feature-name。
3. 进行更改并彻底测试。
4. 提交更改：git commit -m 'Add feature-name'。
5. 推送到分支：git push origin feature-name。
6. 提交拉取请求。

📄 许可证

本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。

🙏 致谢

• 基于 Anthropic 的 Model Context Protocol (MCP) 构建。
• 由 OpenAI 的 GPT-5 API 提供支持。
• 为 Claude Code 社区创建。

📞 支持

• 问题反馈：GitHub Issues
• 讨论交流：GitHub Discussions
• 文档参考：MCP Documentation

⭐ 如果觉得有用，请给这个仓库点个星！