MCPStudio：模型上下文协议的邮差平台

简介

MCPStudio 是一个强大且用户友好的平台，专用于创建、测试、管理和发现模型上下文协议（MCP）服务器。与 Postman 命性地改变 API 开发和测试方式类似，MCPStudio 通过直观的可视化界面与 MCP 服务器交互，简化了底层技术复杂性。

什么是模型上下文协议 (MCP)?

模型上下文协议是一项标准，使 AI 系统（如大型语言模型）能够无缝连接到外部工具、服务或其他系统。MCP 定义了 AI 代理与其环境之间的接口，使得这些代理能够执行操作并获取结果。

核心架构

后端

• 语言：Python
• 框架：FastAPI
• 依赖管理：UV
• 配置：
  • 端口：8000
  • 文档：/docs

前端

• 语言：React
• 状态管理：Redux
• 样式：Tailwind CSS
• 构建工具：Webpack

功能模块

服务器管理

• 创建、列表、更新和删除 MCP 服务器。
• 支持连接和断开与服务器的连接。

工具管理

• 列出特定服务器的所有可用工具。
• 执行指定工具的操作。

认证

• JWT 基础认证。
• 支持 Google OAuth 登录。

实现阶段

后端 (Python)

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
   

工作原理

1. 用户通过界⾯创建 MCP 服务器。
2. 平台向服务器发送连接请求。
3. 成功连接后，用户可以查看和管理服务器上的工具。
4. 执行工具操作时，平台接收并展示结果。

技术栈

后端

• 框架：FastAPI
• 语言：Python
• 依赖管理：UV
• 配置：
  • 端口：8000
  • 文档：/docs

前端

• 框架：React
• 状态管理：Redux
• 样式：Tailwind CSS
• 构建工具：Webpack

项目结构

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

安装指南

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

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 前，请确保代码通过所有测试。

许可证

本项目遵循 MIT 协议。请查看 LICENSE 文件以获取详细信息。

联系方式

如有任何问题或建议，请联系：

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