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

⭐ 如果覺得有用，請給這個倉庫點個星！