Ultra MCP

🚀 Ultra MCP

🚀 Ultra MCP 是一個模型上下文協議（MCP）服務器，它通過單一的 MCP 接口暴露 OpenAI 和 Gemini AI 模型，可供 Claude Code 和 Cursor 使用。

🚀 快速開始

安裝

# 通過 npm 全局安裝
npm install -g ultra-mcp

# 或者直接使用 npx 運行
npx -y ultra-mcp config

配置

通過以下命令交互式設置 API 密鑰：

npx -y ultra-mcp config

此命令將：

1. 顯示當前配置狀態。
2. 允許你設置/更新 OpenAI、Google Gemini 和 Azure 的 API 密鑰。
3. 將配置安全地存儲在你的系統中。
4. 在服務器啟動時自動加載 API 密鑰。

運行服務器

# 運行 MCP 服務器
npx -y ultra

# 或者在本地構建後運行
npm run build
node dist/cli.js

✨ 主要特性

• 🤖 多模型支持：集成 OpenAI（O3）、Google Gemini（2.5 Pro）和 Azure AI 模型。
• 🔌 MCP 協議：標準的模型上下文協議接口。
• 🧠 深度推理工具：使用 O3 模型解決複雜問題。
• 🔍 調查與研究：內置工具可進行全面的調查和研究。
• 🌐 谷歌搜索集成：Gemini 2.5 Pro 支持實時網絡搜索。
• ⚡ 實時流式傳輸：通過 Vercel AI SDK 實現模型實時響應。
• 🔧 零配置：交互式設置，提供智能默認值。
• 🔑 安全配置：使用 conf 庫進行本地 API 密鑰存儲。
• 🧪 TypeScript 支持：提供完整的類型安全和現代開發體驗。

📦 安裝指南

安裝方式

# 通過 npm 全局安裝
npm install -g ultra-mcp

# 或者直接使用 npx 運行
npx -y ultra-mcp config

配置 API 密鑰

npx -y ultra-mcp config

運行服務器

# 運行 MCP 服務器
npx -y ultra

# 或者在本地構建後運行
npm run build
node dist/cli.js

💻 使用示例

基礎用法

// 在支持 MCP 的 Claude Code 或 Cursor 中
await use_mcp_tool("ultra-mcp", "deep-reasoning", {
  provider: "openai",
  prompt: "Design a distributed caching system for microservices",
  reasoningEffort: "high"
});

📚 詳細文檔

CLI 命令

Ultra MCP 提供了幾個強大的命令：

config - 交互式配置

npx -y ultra-mcp config

通過用戶友好的菜單系統交互式配置 API 密鑰。

dashboard - 網頁儀表盤

npx -y ultra-mcp dashboard

# 自定義端口
npx -y ultra-mcp dashboard --port 4000

# 開發模式
npx -y ultra-mcp dashboard --dev

啟動網頁儀表盤，查看使用統計信息、管理配置並監控 AI 成本。

install - 為 Claude Code 安裝

npx -y ultra-mcp install

自動將 Ultra MCP 作為 MCP 服務器安裝到 Claude Code 中。

doctor - 健康檢查

npx -y ultra-mcp doctor

# 測試與供應商的連接
npx -y ultra-mcp doctor --test

檢查安裝健康狀況並測試 API 連接。

chat - 交互式聊天

npx -y ultra-mcp chat

# 指定模型和供應商
npx -y ultra-mcp chat -m o3-mini -p openai

從命令行與 AI 模型進行交互式聊天。

數據庫命令

db:show - 顯示數據庫信息

npx -y ultra-mcp db:show

顯示數據庫文件位置和基本統計信息。

db:stats - 使用統計信息

npx -y ultra-mcp db:stats

顯示過去 30 天的詳細使用統計信息，包括按供應商劃分的成本。

db:view - 數據庫查看器

npx -y ultra-mcp db:view

啟動 Drizzle Studio 以交互式探索使用數據庫。

與 Claude Code 集成

自動安裝（推薦）

# 為 Claude Code 安裝 Ultra MCP
npx -y ultra-mcp install

此命令將：

• 檢測 Claude Code 安裝情況。
• 將 Ultra MCP 添加為 MCP 服務器。
• 為用戶或項目範圍進行配置。
• 驗證 API 密鑰配置。

手動安裝

添加到你的 Claude Code 設置中：

{
  "mcpServers": {
    "ultra-mcp": {
      "command": "npx",
      "args": ["-y", "ultra"]
    }
  }
}

與 Cursor 集成

首先配置你的 API 密鑰：

npx -y ultra-mcp config

然後添加到你的 Cursor MCP 設置中：

{
  "mcpServers": {
    "ultra-mcp": {
      "command": "npx", 
      "args": ["-y", "ultra"]
    }
  }
}

Ultra MCP 將自動使用你通過 config 命令配置的 API 密鑰。

MCP 工具

Ultra MCP 提供了可通過 Claude Code 和 Cursor 訪問的強大 AI 工具：

🧠 深度推理 (deep-reasoning)

利用高級 AI 模型進行復雜問題解決和分析。

• 默認設置：OpenAI/Azure 使用 O3-mini，Google 使用帶谷歌搜索的 Gemini 2.5 Pro。
• 用例：複雜算法、架構決策、深度分析。

🔍 調查 (investigate)

以可配置的深度級別徹底調查主題。

• 深度級別：淺、中、深。
• 谷歌搜索：Gemini 默認啟用。
• 用例：研究主題、探索概念、收集見解。

📚 研究 (research)

以多種輸出格式進行全面研究。

• 輸出格式：摘要、詳細、學術。
• 用例：文獻綜述、技術比較、文檔編寫。

📋 列出模型 (list-ai-models)

查看所有可用的 AI 模型及其配置狀態。

🔧 技術細節

架構

Ultra MCP 充當多個 AI 模型供應商和 MCP 客戶端之間的橋樑：

1. MCP 協議層：實現用於與 Claude Code/Cursor 通信的模型上下文協議。
2. 模型供應商：通過 Vercel AI SDK 集成 OpenAI、Google（Gemini）和 Azure AI。
3. 統一接口：通過單一 MCP 接口訪問多個 AI 模型。
4. 配置管理：安全的本地存儲，帶有模式驗證。

關鍵組件

• src/cli.ts - 使用 commander 的 CLI 入口點。
• src/server.ts - MCP 服務器實現。
• src/config/ - 帶有模式驗證的配置管理。
• src/handlers/ - MCP 協議處理程序。
• src/providers/ - 模型供應商實現。
• src/utils/ - 用於流式傳輸和錯誤處理的共享實用程序。

配置存儲

Ultra MCP 將配置存儲在系統的默認配置目錄中：

• macOS：~/Library/Preferences/ultra-mcp-nodejs/
• Linux：~/.config/ultra-mcp/
• Windows：%APPDATA%\ultra-mcp-nodejs\

環境變量

你還可以通過環境變量設置 API 密鑰：

• OPENAI_API_KEY
• GOOGLE_API_KEY
• AZURE_API_KEY
• AZURE_ENDPOINT

注意：配置文件優先於環境變量。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

致謝

• Google 的 Agent2Agent (A2A) 協議 啟發了代理互操作性。
• BeehiveInnovations 的 Zen MCP 展示了 AI 模型編排。
• Anthropic 的 模型上下文協議。
• Vercel 的優秀 AI SDK。

關於作者

👋 Mike Chong - 通過 AI 構建工具以放大人類潛力。

作為 GitHub Copilot 最早的 用戶 之一（由前 GitHub 首席執行官 Nat Friedman 親自邀請），我親眼目睹了 AI 輔助開發如何改變我們構建軟件的方式。我曾在 Outlook iOS/Android 擔任工程師，這段經歷讓我明白創建真正改善人們日常生活的工具的重要性。

Ultra MCP 代表了我將最佳 AI 模型普及化的願景，通過統一、簡單的接口讓每個開發者都能使用最前沿的 AI 功能。我相信，消除開發者與 AI 模型之間的障礙，我們可以加速創新，為每個人創造更美好的世界。

“未來屬於那些能夠無縫協調人類創造力和 AI 能力的人。”

Ultra MCP 與 Zen MCP 服務器的區別

雖然兩個項目都旨在增強 AI 開發工作流程，但 Ultra MCP 帶來了獨特的優勢：

1. 使用 TypeScript 編寫 - 與基於 Python 的替代方案相比，具有完整的類型安全、更好的 IDE 支持和更易於維護的代碼庫。
2. 內置使用分析 - 由 libsql 驅動的輕量級 SQLite 數據庫，用於自動跟蹤 LLM 使用情況和監控成本。在我看來，不知道使用成本就使用 AI 並不是一個好主意。

這些特性使 Ultra MCP 特別適合那些希望擁有強大工具並能瞭解成本情況以負責任地使用 AI 的開發者。

鏈接

• 模型上下文協議
• Agent2Agent 協議
• Zen MCP 服務器
• Claude Code
• Cursor IDE