Mcpstudio

🚀 MCPStudio：模型上下文協議的郵差平臺

MCPStudio 是一款強大且易用的平臺，專注於創建、測試、管理和發現模型上下文協議（MCP）服務器。如同 Postman 革新 API 開發和測試方式一樣，MCPStudio 藉助直觀的可視化界面與 MCP 服務器交互，簡化了底層技術的複雜性。

🚀 快速開始

安裝步驟

1. 克隆倉庫：

   git clone https://github.com/lonexreb/mcpstudio.git
   cd mcpstudio
   

2. 設置後端：

   cd backend/mcp_studio_backend
   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install uv
   uv pip install -e .
   

3. 設置前端：

   cd frontend/ai-server-forge
   npm install
   

4. 啟動開發服務器

   • 後端：

     cd backend/mcp_studio_backend
     uvicorn mcp_studio.main:app --reload
     

   • 前端：

     cd frontend/ai-server-forge
     npm run dev
     

5. 打開瀏覽器，訪問 http://localhost:3000

工作流程

1. 用戶通過界⾯創建 MCP 服務器。
2. 平臺向服務器發送連接請求。
3. 成功連接後，用戶可以查看和管理服務器上的工具。
4. 執行工具操作時，平臺接收並展示結果。

✨ 主要特性

服務器管理

• 可創建、列出、更新和刪除 MCP 服務器。
• 支持連接和斷開與服務器的連接。

工具管理

• 能列出特定服務器的所有可用工具。
• 可執行指定工具的操作。

認證

• 採用 JWT 基礎認證。
• 支持 Google OAuth 登錄。

📦 安裝指南

後端安裝

1. 初始化環境：

   python -m venv venv
   source venv/bin/activate  # Windows: venv\Scripts\activate
   pip install uv
   uv pip install -e .
   

2. 配置文件路徑：

   mcpstudio/
   ├── backend/
   │   └── mcp_studio/
   │       ├── config.py
   │       └── main.py
   └── frontend/
       └── ai-server-forge/
           └── package.json
   

前端安裝

在前端目錄下執行 npm install 進行依賴安裝。

💻 使用示例

後端初始化環境示例

python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install uv
uv pip install -e .

提交代碼示例

git checkout main
git pull origin main
git checkout feature/my-feature
# 開發...
git add .
git commit -m "feat: 添加新功能"
git push origin feature/my-feature

📚 詳細文檔

什麼是模型上下文協議 (MCP)?

模型上下文協議是一項標準，使 AI 系統（如大型語言模型）能夠無縫連接到外部工具、服務或其他系統。MCP 定義了 AI 代理與其環境之間的接口，使得這些代理能夠執行操作並獲取結果。

核心架構

後端

前端

API 端點

服務器管理

• POST /api/servers - 創建新服務器
• GET /api/servers - 列出所有服務器
• GET /api/servers/{server_id} - 獲取服務器詳情
• PUT /api/servers/{server_id} - 更新服務器
• DELETE /api/servers/{server_id} - 刪除服務器
• POST /api/servers/{server_id}/connect - 連接服務器
• POST /api/servers/{server_id}/disconnect - 斷開連接

工具管理

• GET /api/servers/{server_id}/tools - 列出服務器上的工具
• GET /api/tools/{tool_id} - 獲取工具詳情
• POST /api/servers/{server_id}/tools/{tool_id}/execute - 執行工具操作

認證

• POST /api/auth/token - 獲取 JWT 訪問令牌
• GET /api/auth/google/auth - 獲取 Google OAuth 鏈接
• GET /api/auth/google/callback - 處理 Google OAuth 回調
• GET /api/auth/user - 獲取當前用戶信息

貢獻指南

1. 提交代碼時，請遵循 Git 工作流：

   git checkout main
   git pull origin main
   git checkout feature/my-feature
   # 開發...
   git add .
   git commit -m "feat: 添加新功能"
   git push origin feature/my-feature
   

2. 提交 Pull Request 前，請確保代碼通過所有測試。

🔧 技術細節

後端

• 框架：FastAPI
• 語言：Python
• 依賴管理：UV
• 配置：
  • 端口：8000
  • 文檔：/docs

前端

• 框架：React
• 狀態管理：Redux
• 樣式：Tailwind CSS
• 構建工具：Webpack

📄 許可證

本項目遵循 MIT 協議。請查看 LICENSE 文件以獲取詳細信息。

📞 聯繫方式

如有任何問題或建議，請聯繫：

• 郵箱：contact@example.com
• GitHub：https://github.com/lonexreb/mcpstudio