使用说明

项目简介

MCP Agents Hub 是一个为 Model Context Protocol (MCP) 生态系统设计的中心枢纽，旨在促进 MCP 服务器和客户端的构建、发现和部署。它提供了一个平台，让开发者可以分享和查找预构建的 MCP 服务器，加速企业级上下文感知 AI 应用的开发。您可以将其理解为一个 MCP 服务器的“应用商店”或“资源中心”。

主要功能点

服务器构建资源: 提供 MCP 服务器开发的模板、示例和最佳实践，降低开发门槛。
客户端开发支持: 为构建利用 MCP 协议的 AI 应用提供标准化接口和工具。
服务器发现: 用户可以浏览和发现针对常见企业系统的预构建 MCP 服务器，例如 Google Drive、Slack、GitHub 等。
企业级部署: 支持本地部署，以满足企业对安全性和合规性的需求。
MCP 生态系统中心: 作为 MCP 服务器和客户端的管理和发现平台。

安装步骤

克隆仓库

git clone https://github.com/mcp-agents-ai/mcp-agents-hub.git
cd mcp-agents-hub

安装依赖
```
npm install
```

服务器配置

MCP Agents Hub 本身作为一个服务器运行，为 MCP 客户端提供服务发现和元数据信息。对于 MCP 客户端，需要配置访问 MCP Agents Hub 服务器的地址，以便查询和获取 MCP 服务器的信息。

以下是一个 MCP 客户端配置示例，用于连接 MCP Agents Hub 服务器：

{
  "serverName": "MCP Agents Hub Server",
  "command": "访问 MCP Agents Hub API",
  "args": {
    "apiBaseUrl": "http://localhost:3001/v1/hub"  // MCP Agents Hub 服务器的 API 基础 URL，默认为本地开发环境
    // 客户端可以通过此 URL 查询服务器列表、服务器详情等
  },
  "description": "连接到 MCP Agents Hub 服务器以发现和管理 MCP 服务器。",
  "notes": "请确保 MCP Agents Hub 服务器已启动并可访问。"
}

配置参数说明:

'apiBaseUrl': MCP Agents Hub 服务器的 API 基础 URL。MCP 客户端需要配置此地址才能与 MCP Agents Hub 服务器通信，查询服务器列表、获取服务器详细信息等。默认情况下，如果您在本地运行 MCP Agents Hub 服务器，则可以使用 'http://localhost:3001/v1/hub'。如果 MCP Agents Hub 服务器部署在其他地址，请相应地修改此 URL。

注意: MCP Agents Hub 服务器本身不是直接连接数据源或提供工具的 MCP 服务器。它是一个 MCP 服务器元数据管理平台。MCP 客户端连接到 MCP Agents Hub 服务器是为了发现和获取其他 MCP 服务器的信息，而不是直接与数据源交互。

基本使用方法

启动 MCP Agents Hub 服务器
```
npm run dev
```
这将启动开发服务器，默认监听 'http://localhost:3001'。
访问 API 接口 您可以使用 HTTP 客户端（如 curl, Postman 或浏览器）访问 MCP Agents Hub 服务器提供的 API 接口，例如：
- 获取 MCP 服务器列表: 'GET http://localhost:3001/v1/hub/servers'
- 获取指定 MCP 服务器详情: 'GET http://localhost:3001/v1/hub/servers/{hubId}' (将 '{hubId}' 替换为实际的服务器 Hub ID)
这些接口返回 JSON 格式的数据，包含了 MCP 服务器的元数据信息，例如名称、描述、GitHub 仓库地址等。MCP 客户端可以解析这些数据，并根据需要连接到具体的 MCP 服务器。
集成到 MCP 客户端 在您的 MCP 客户端应用中，配置连接到 MCP Agents Hub 服务器的 API 地址（'apiBaseUrl'）。客户端可以通过调用 MCP Agents Hub 服务器的 API 获取服务器列表和详情，并展示给用户，或根据这些信息动态配置和连接到实际的 MCP 服务器。

通过 MCP Agents Hub，您可以更方便地管理和发现 MCP 生态系统中的各种服务器资源，加速构建基于 MCP 的上下文感知 AI 应用。

MCP Agents Hub