使用说明

MCP集线器

███╗   ███╗ ██████╗██████╗     ██╗  ██╗██╗   ██╗██████╗
████╗ ████║██╔════╝██╔══██╗    ██║  ██║██║   ██║██╔══██╗
██╔████╔██║██║     ██████╔╝    ███████║██║   ██║██████╔╝
██║╚██╔╝██║██║     ██╔═══╝     ██╔══██║██║   ██║██╔══██╗
██║ ╚═╝ ██║╚██████╗██║         ██║  ██║╚██████╔╝██████╔╝
╚═╝     ╚═╝ ╚═════╝╚═╝         ╚═╝  ╚═╝ ╚═════╝ ╚═════╝

MCP的npm

轻松发现、安装和管理模型上下文协议服务器

🚀 快速开始 • 📖 文档 • 🔍 命令 • 🎯 示例

🌟 什么是MCP Hub？

MCP Hub是一个 强大的命令行工具 这使得发现、安装和管理成为可能模型上下文协议（MCP）服务器就像使用npm一样简单。它提供了一个精心策划的流行MCP服务器注册表，与Claude Code无缝集成，以及美丽的CLI体验。

为什么选择MCP Hub？

📦 管理登记处：通过搜索和过滤访问7260+MCP服务器
⚡ 一个命令安装：使用单个命令安装任何MCP服务器
🔧 自动配置：自动为您配置Claude代码
✨ 漂亮的CLI：带有颜色、表格和旋转器的华丽终端UI
🔍 智能搜索：按名称、类别或描述查找包
🩺 健康检查：内置诊断功能，确保一切正常
🛡️ 安全第一：已验证的包裹和安全扫描集成

🚀 快速开始

安装

# Install globally via npm
npm install -g mcp-hub

# Or use via npx (no installation needed)
npx mcp-hub

基本用法

# Search for MCP servers
mcp search github

# Get detailed info about a package
mcp info github

# Install an MCP server
mcp install github

# List installed packages
mcp list

# View all available categories
mcp categories

# Run system diagnostics
mcp doctor

📖 文档

什么是MCP服务器？

这 模型上下文协议 （MCP）是一种开放协议，使像Claude这样的人工智能助手能够安全地连接到外部工具、API和数据源。MCP服务器通过标准化接口提供这些功能。

常见用例：

🐙 GitHub集成：管理仓库、问题和PR
📁 文件系统访问：安全地读/写本地文件
🌐 Web自动化：使用Puppeteer进行浏览器控制
🔍 网页搜索：勇敢搜索、谷歌、困惑
💾 数据库访问：PostgreSQL、MySQL、MongoDB
💬 聊天集成：懒散、不和谐、团队
🧠 增强推理：顺序思维、记忆

🔍 命令

`mcp search <query>`

按名称或描述搜索MCP服务器。

# Basic search
mcp search github

# Search by category
mcp search database --category data

# Show only verified packages
mcp search api --verified

# Limit results
mcp search web --limit 5

选项：

--category <name> -按类别筛选
--verified -仅显示已验证的包
--limit <n> -限制结果数量

`mcp install <package>`

安装MCP服务器并自动配置Claude Code。

# Install a package
mcp install github

# Install with custom configuration
mcp install postgres

安装过程中会发生什么：

✅ 验证注册表中是否存在包
📦 通过npm/npx下载和安装
⚙️ 添加到Claude代码配置
💾 保存安装元数据
✨ 立即可用（在Claude Code重新启动后）

`mcp list`

列出已安装或可用的软件包。

# List installed packages
mcp list

# List all available packages
mcp list --all

选项：

--all -显示所有可用软件包（不仅仅是已安装的）

`mcp info <package>`

获取有关MCP服务器的详细信息。

mcp info github

显示：

包名称、版本、描述
类别、作者、许可证
GitHub星级，验证状态
安装类型和命令
存储库和主页链接
标签和元数据

`mcp config`

查看当前的Claude Code MCP配置。

# View configuration
mcp config

# View with JSON output
mcp config --json

选项：

--json -输出原始JSON配置
--path -仅显示配置文件路径

`mcp uninstall <package>`

卸下已安装的MCP服务器。

mcp uninstall github

`mcp categories`

列出所有可用的套餐类别。

mcp categories

可用类别：

开发（GitHub、GitLab）
文件系统（文件操作）
Web（木偶剧，剧作家）
搜索（Brave、谷歌）
数据库（PostgreSQL、MySQL）
沟通（松弛、不和谐）
人工智能工具（顺序思维）

`mcp doctor`

运行系统诊断以确保MCP Hub正常工作。

mcp doctor

检查：

✅ Node.js版本（要求>=18）
✅ Claude代码配置文件存在
✅ 已安装的软件包有效
✅ npx可用
✅ 系统运行状况摘要

🎯 示例

示例1：设置GitHub集成

# Search for GitHub packages
$ mcp search github

┌──────────┬─────────────────────────────────────┬─────────────┬───────┬──────────┐
│ Name     │ Description                         │ Category    │ Stars │ Verified │
├──────────┼─────────────────────────────────────┼─────────────┼───────┼──────────┤
│ github   │ GitHub MCP server - manage issues...│ Development │ 1234  │ ✓        │
└──────────┴─────────────────────────────────────┴─────────────┴───────┴──────────┘

# Get detailed info
$ mcp info github

# Install
$ mcp install github

# Restart Claude Code and start using!

示例2：数据库开发设置

# Install PostgreSQL MCP server
$ mcp install postgres

# List installed packages
$ mcp list

Installed MCP Servers:
┌──────────┬─────────────────────────────────────┬──────────┐
│ Name     │ Description                         │ Version  │
├──────────┼─────────────────────────────────────┼──────────┤
│ postgres │ PostgreSQL database integration     │ 1.0.0    │
└──────────┴─────────────────────────────────────┴──────────┘

示例3：Web自动化工作流

# Search for web automation tools
$ mcp search web --category web

# Install Puppeteer MCP
$ mcp install puppeteer

# Verify installation
$ mcp doctor

✔ Node.js version v18.17.0 ✓
✔ Claude config file exists ✓
✔ 1 package(s) installed ✓
✔ npx is available ✓

✓ MCP Hub is ready to use!

🏗️ 建筑

MCP Hub采用模块化架构构建：

┌─────────────────────────────────────────────┐
│              CLI Interface                   │
│  (Commander.js + Beautiful Output)           │
└─────────────────┬───────────────────────────┘
                  │
         ┌────────┴────────┐
         │                 │
┌────────▼────────┐ ┌─────▼──────────────┐
│  MCP Registry   │ │  Config Manager    │
│  - Search       │ │  - Claude Config   │
│  - Filter       │ │  - Install Tracking│
│  - Metadata     │ │  - Backups         │
└─────────────────┘ └────────────────────┘

关键部件：

命令行界面 (src/cli.ts)：带有ASCII横幅的漂亮命令行界面
注册表 (src/registry/)：带搜索功能的套餐注册表
配置项管理 (src/utils/config-manager.ts)：Claude代码集成
命令 (src/commands/)：模块化命令实现

🔧 配置

Claude代码集成

MCP Hub通过修改以下内容自动配置Claude Code：

macOS/Linux：

~/.config/claude/claude_desktop_config.json

窗户：

%APPDATA%\Claude\claude_desktop_config.json

添加了示例配置：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "<your-token>"
      }
    }
  }
}

自定义注册表

您可以使用自定义注册表扩展MCP Hub：

// Future feature - config file support
// ~/.mcp-hub/config.json
{
  "registries": [
    "https://registry.mcphub.io/api/v1",
    "https://my-custom-registry.com/mcp"
  ]
}

🛡️ 安全

MCP Hub非常重视安全：

已验证的套餐：经过精心策划的包装上标有✓
来源透明度：所有包都链接到源代码存储库
无任意代码：只能通过npm/npx安装
配置备份：修改前自动备份
安全扫描：与Socket.dev集成（即将推出）

最佳实践：

安装前务必查看软件包信息
尽可能使用经过验证的软件包
检查存储库星级和活动
审查所需的环境变量
保持包更新

📊 包注册表

MCP Hub包括一个精选的流行MCP服务器注册表：

包装	描述	类别	星级
GitHub	GitHub集成（问题、PR、repos）	开发	1234
文件系统	安全的文件系统操作	文件系统	2100
操纵者	浏览器自动化和网络抓取	网络	1890
勇敢的搜寻	通过勇敢的API进行网络搜索	搜索	756
Postgres	PostgreSQL数据库访问	数据库	892
松弛	Slack消息集成	通信	645
顺序思维	增强推理能力	人工智能工具	1123

注册表总计： 7260+个包裹（每日增长）

🚧 路线图

v1.0（当前）

✅ 具有搜索、安装和列表功能的核心CLI
✅ 整理好的包注册表
✅ Claude代码集成
✅ 系统诊断
✅ 漂亮的终端UI

v1.1（下一页）

🔄 从远程API获取动态注册表
🔄 包更新通知
🔄 交互式包配置
🔄 多注册表支持

v2.0（未来）

📦 包发布工作流
🔍 模糊匹配高级搜索
🛡️ 内置安全扫描
📊 使用分析和建议
🎨 CLI的自定义主题
🌐 用于包发现的Web仪表板

🤝 贡献

我们欢迎捐款！以下是如何开始：

开发设置

# Clone repository
git clone https://github.com/yourusername/mcp-hub.git
cd mcp-hub

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run locally
node dist/cli.js --help

# Run tests
npm test

将包添加到注册表

要向注册表添加新包，请执行以下操作：

编辑 src/registry/packages.ts

添加您的包元数据：

{
  name: 'my-package',
  description: 'Description here',
  version: '1.0.0',
  category: 'Development',
  installType: 'npm',
  installCommand: '@my/mcp-server',
  repository: 'https://github.com/user/repo',
  verified: false,
  stars: 0
}

提交拉取请求

指南

遵循TypeScript的最佳实践
为新功能添加测试
更新文档
使用常规提交
确保 npm run build 通过

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。

🙏 致谢

Anthropic -用于Claude Code和MCP协议
MCP社区 -用于创建出色的服务器
贡献者 -使MCP Hub更好

📞 支持

文档: https://mcp-hub.dev
问题: GitHub问题
讨论: GitHub讨论
推特: @mcp_hub

由以下材料制成❤️ MCP社区

⭐ 在GitHub上为我们投票🐦 在推特上关注|📖 阅读文档

使用说明

MCP集线器

🌟 什么是MCP Hub？

为什么选择MCP Hub？

🚀 快速开始

安装

基本用法

📖 文档

什么是MCP服务器？

🔍 命令

mcp search <query>

mcp install <package>

mcp list

mcp info <package>

mcp config

mcp uninstall <package>

mcp categories

mcp doctor

🎯 示例

示例1：设置GitHub集成

示例2：数据库开发设置

示例3：Web自动化工作流

🏗️ 建筑

🔧 配置

Claude代码集成

自定义注册表

🛡️ 安全

📊 包注册表

🚧 路线图

v1.0（当前）

v1.1（下一页）

v2.0（未来）

🤝 贡献

开发设置

将包添加到注册表

指南

📄 许可证

🙏 致谢

📞 支持

相关 MCP

AKShare One MCP 股市数据服务

实时网络搜索服务

arXiv 论文检索 MCP 服务器

移动自动化MCP服务器

AI持久记忆服务器

Git仓库管理MCP服务器

`mcp search <query>`

`mcp install <package>`

`mcp list`

`mcp info <package>`

`mcp config`

`mcp uninstall <package>`

`mcp categories`

`mcp doctor`