使用说明

项目简介

MCP Host Framework 是一个用于构建模块化 MCP (Model Context Protocol) 服务器的框架。它旨在帮助开发者轻松创建和管理工具、服务，并通过标准化的 MCP 协议与 LLM 客户端进行通信。该框架提供了动态服务器和工具发现、可配置组件注册、异步工具执行等核心功能，为构建强大的 LLM 应用后端提供支持。

主要功能点

动态服务器和工具发现：框架能够自动发现和注册可用的 MCP 服务器和工具，简化部署和扩展。
可配置组件注册：允许灵活配置和注册服务器组件，包括工具、资源和 Prompt 模板。
异步工具执行：支持异步执行工具，提高服务器性能和响应速度。
灵活的日志和配置管理：提供可配置的日志记录和配置管理，方便运维和调试。
可扩展架构：框架采用可扩展架构设计，方便添加新的服务器类型和功能模块。

安装步骤

克隆仓库

git clone https://github.com/chrishayuk/mcp-host.git
cd mcp-host

创建虚拟环境
```
make venv
```
安装依赖
```
make rebuild
```

服务器配置

MCP 服务器需要通过启动命令和参数运行。以下是 MCP 客户端连接 MCP 服务器时需要配置的 JSON 格式信息。其中，'server name' 需要与 'config.yaml' 中 'host.name' 的配置保持一致（默认为 'generic-mcp'）。

{
  "server name": "generic-mcp",  // MCP 服务器的名称，需与服务器配置一致
  "command": "uv",             // 启动命令，这里使用 uv 包管理器
  "args": [                     // 启动参数
    "run",
    "python",
    "runtime/src/mcp_server/main.py"
  ]
}

或者，您也可以使用 'make run-server' 命令启动服务器，此时 'command' 和 'args' 的配置可以相应调整。

基本使用方法

启动 MCP 服务器后，可以使用 'mcp-cli' 命令行工具与之交互。

与通用服务器聊天

uv run mcp-cli chat --server generic

列出可用工具

uv run mcp-cli list-tools

更多使用方法请参考仓库 README 文档和 'mcp-cli' 工具的帮助信息。

关键词