使用说明
MCP集线器
用于集中管理模型上下文协议(MCP)服务器的跨平台桌面应用程序。配置MCP服务器一次,并将配置部署到多个AI客户端应用程序。
特性
核心功能
- 中央服务器注册表:在一个地方管理所有MCP服务器配置
- 多客户端支持:同时部署40多个AI客户端应用程序
- 客户端实例:为每个客户创建多个配置文件(例如,“工作”和“个人”)
- 服务器实例:创建具有不同配置的同一服务器的多个实例
- 服务器到实例映射:有选择地为每个客户端实例启用服务器
- 配置同步:单击同步以更新客户端配置文件
- 自动备份:在修改任何配置文件之前创建备份
服务器管理
- 从文件导入:从任何客户端的配置文件导入现有的MCP配置
- 服务器注册表:从多个服务器注册表浏览和安装:
- MCP Hub内置(55台以上精心策划的服务器)
- Anthropic官方(19台服务器)
- 出色的MCP服务器(100+社区服务器)
- Smithery注册表(200多台服务器)
- Glama MCP目录(150多台服务器)
- mcp-get注册表(80多台服务器)
- 自定义注册表:从本地文件或远程URL(包括私有GitHub存储库)添加自己的注册表
- 环境变量:配置服务器特定的环境变量
- 标签:使用自定义标签组织服务器,以便于过滤
安全
- 安全凭证存储:使用操作系统本机安全存储(macOS钥匙链、Windows凭据管理器、Linux特勤局)
- 配置文件保存:安全地将MCP配置与现有设置合并(例如,Claude Code的
.claude.json)
发现(实验)
- MCP目录:通过以下方式公开服务器
~/.mcp/兼容客户端目录 - HTTP发现服务器:用于程序化服务器发现的本地HTTP服务器
支持的客户
MCP Hub支持所有主要平台上的40多个AI客户端:
人工智能助理和聊天
| 客户端 | macOS | Windows | Linux |
|---|---|---|---|
| 克劳德桌面 | ✓ | ✓ | ✓ |
| 克劳德代码 | ✓ | ✓ | ✓ |
| 困惑桌面 | ✓ | ✓ | ✓ |
| BoltAI | ✓ | - | - |
代码编辑器和IDE
| 客户端 | macOS | Windows | Linux |
|---|---|---|---|
| VS代码 | ✓ | ✓ | ✓ |
| VS代码内幕人士 | ✓ | ✓ | ✓ |
| 光标 | ✓ | ✓ | ✓ |
| 风浪 | ✓ | ✓ | ✓ |
| Zed | ✓ | ✓ | ✓ |
| Visual Studio 2022 | - | ✓ | - |
| JetBrains集成开发环境✓ | ✓ | ✓ |
AI编码扩展
| 客户端 | macOS | Windows | Linux |
|---|---|---|---|
| 克莱恩 | ✓ | ✓ | ✓ |
| 继续 | ✓ | ✓ | ✓ |
| 源代码图科迪 | ✓ | ✓ | ✓ |
| Roo代码 | ✓ | ✓ | ✓ |
| 基洛代码 | ✓ | ✓ | ✓ |
| 增强代码 | ✓ | ✓ | ✓ |
| Qodo Gen | ✓ | ✓ | ✓ |
| GitHub副本 | ✓ | ✓ | ✓ |
CLI工具
| 客户端 | macOS | Windows | Linux |
|---|---|---|---|
| 放大器 | ✓ | ✓ | ✓ |
| Gemini CLI | ✓ | ✓ | ✓ |
| 亚马逊Q开发者✓ | ✓ | ✓ | |
| Rovo开发CLI | ✓ | ✓ | ✓ |
| OpenAI Codex✓ | ✓ | ✓ | |
| Copilot命令行界面 | ✓ | ✓ | ✓ |
其他客户
| 客户端 | macOS | Windows | Linux |
|---|---|---|---|
| LM工作室 | ✓ | ✓ | ✓ |
| 谷歌反重力✓ | ✓ | ✓ | |
| 史密瑟里 | ✓ | ✓ | ✓ |
| 自定义 | ✓ | ✓ | ✓ |
还有更多。..
安装
预构建二进制文件
下载适用于您平台的最新版本:
- macOS:
MCP Hub_x.x.x_aarch64.dmg(苹果硅)或MCP Hub_x.x.x_x64.dmg(英特尔) - 视窗:
MCP Hub_x.x.x_x64-setup.exe - Linux:
MCP Hub_x.x.x_amd64.AppImage或.deb
从源代码构建
先决条件
步骤
# Clone the repository
git clone https://github.com/yourusername/mcp-hub.git
cd mcp-hub
# Install dependencies
pnpm install
# Run in development mode
pnpm tauri dev
# Build for production
pnpm tauri build
用法
添加服务器
- 导航到 服务器 视图
- 点击 添加服务器 或 导入 从注册表/文件添加
- 填写服务器详细信息:
- 名字:人类可读名称
- 命令:可执行文件(例如。,
npx,uvx,node,python) - 参数:命令参数(每行一个)
- 环境变量:KEY=值对(每行一个)
- 标签:逗号分隔的组织标记
- 点击 添加服务器
创建服务器实例
要运行具有不同配置的同一服务器的多个实例,请执行以下操作:
- 在中查找服务器 服务器 视图
- 点击 复制 创建实例的图标
- 根据需要修改名称、参数或环境变量
- 点击 添加服务器 创建实例
实例与其父服务器在视觉上分组,并显示“实例”徽章。
从注册表导入
- 点击 导入 在“服务器”视图中
- 从可用源中选择注册表
- 浏览或搜索服务器
- 选择要导入的服务器
- 点击 导入所选内容
自定义注册表
您可以创建自己的服务器注册表,以便在团队或组织内共享MCP配置。
添加自定义注册表
- 点击 导入 在“服务器”视图中
- 点击 + 注册表下拉列表旁边的按钮
- 输入注册表URL(本地文件路径或远程URL)
- 对于私有GitHub仓库,添加您的GitHub令牌
- 点击 测试连接 证实
- 点击 添加注册表
注册表文件格式
创建具有以下结构的JSON文件:
{
"name": "My Team Registry",
"description": "Internal MCP servers for our team",
"icon": "star",
"servers": [
{
"name": "internal-db-server",
"description": "Connect to our internal databases",
"command": "npx",
"args": ["-y", "@myorg/db-mcp-server"],
"env": {
"DB_HOST": "internal.example.com"
},
"tags": ["database", "internal"],
"repository": "https://github.com/myorg/db-mcp-server"
},
{
"name": "slack-integration",
"description": "Post messages to team Slack channels",
"command": "uvx",
"args": ["slack-mcp"],
"env": {},
"tags": ["messaging", "slack"],
"homepage": "https://example.com/docs/slack-mcp"
}
]
}
注册表文件字段
| 字段 | 必填 | 描述 |
|---|---|---|
name |
是 | 注册表的显示名称 |
description |
否 | 注册表的简要说明 |
icon |
无 | 图标标识符(例如“星形”、“包装”、“屏蔽检查”) |
servers |
是 | 服务器定义数组 |
服务器字段
| 字段 | 必填 | 描述 |
|---|---|---|
name |
是 | 唯一服务器名称 |
description |
否 | 服务器做什么 |
command |
是 | 可执行命令(例如,“npx”、“uvx”和“node”) |
args |
Yes | 命令参数数组 |
env |
否 | 环境变量(对象) |
tags |
否 | 用于分类的标签数组 |
repository |
否 | 源代码存储库URL |
homepage |
否 | 文档或主页URL |
托管选项
- 本地文件:使用类似的文件路径
/path/to/registry.json - 公共URL:任何web服务器或公共GitHub原始URL上的主机
- 私有GitHub:使用带有个人访问令牌的原始GitHub URL进行身份验证
设置客户端实例
- 导航到 实例 视图
- 点击 添加实例
- 选择客户端类型或使用自动检测
- 配置实例名称和配置路径
- 点击 配置服务器 选择要启用的服务器
- 点击 同步 写入配置
同步配置
- 点击 同步 在任何实例上更新其配置文件
- 使用 全部同步处理 在侧边栏中一次同步所有实例
- 每次同步前都会自动创建备份
数据存储
应用程序数据存储在:
| 平台 | 路径 |
|---|---|
| macOS | ~/Library/Application Support/MCP Hub/ |
| 窗户 | %APPDATA%\MCP Hub\ |
| Linux | ~/.config/mcp-hub/ |
数据库
MCP Hub使用SQLite存储:
- 服务器配置
- 客户端实例
- 服务器到实例的映射
- 备份记录
- 应用程序设置
发展
项目结构
mcp-hub/
├── src/ # React frontend
│ ├── components/ # UI components
│ ├── pages/ # Page components
│ │ ├── Dashboard.tsx # Overview dashboard
│ │ ├── Servers.tsx # Server management
│ │ ├── Instances.tsx # Client instance management
│ │ └── Settings.tsx # Application settings
│ ├── store/ # Zustand state management
│ └── types/ # TypeScript types
├── src-tauri/ # Rust backend
│ └── src/
│ ├── commands/ # Tauri command handlers
│ ├── db/ # SQLite database
│ ├── models/ # Data models
│ └── services/
│ ├── config.rs # Config file management
│ ├── credentials.rs # Secure credential storage
│ ├── discovery.rs # MCP discovery features
│ └── registry.rs # Server registry integration
└── ...
技术栈
- 前端:React 19、TypeScript、顺风CSS v4、Radix UI
- 后端:铁锈,牛磺酸2.0
- 数据库:SQLite(通过rusqlite)
- 状态管理状态:
- 安全存储:OS钥匙圈(通过钥匙圈箱)
关键命令
# Development
pnpm tauri dev
# Build
pnpm tauri build
# Type checking
pnpm build # Frontend only
cargo check # Backend only
截图
即将推出
许可证
MIT许可证-有关详细信息,请参阅许可证文件。
贡献
欢迎投稿!在提交PR之前,请阅读投稿指南。
