使用说明

项目简介

MCP Toolbox 是一个旨在增强大型语言模型（LLM）能力的应用工具包，它基于模型上下文协议（MCP）构建，充当 MCP 服务器，为 LLM 客户端提供丰富的工具和服务，扩展 LLM 的功能边界，使其能够与外部世界进行交互。

主要功能点

工具扩展: 集成多种实用工具，包括：
- 命令行工具: 允许 LLM 执行操作系统命令。
- 文件操作工具: 支持 LLM 读取、写入和编辑本地文件。
- Figma 集成工具: 使 LLM 能够访问和操作 Figma 设计文件。
- 音频处理工具: 提供音频文件的时长获取和转录功能。
- 网页工具: 支持 LLM 获取网页内容和进行网络搜索。
- Markdown 转换工具: 帮助 LLM 进行 Markdown 格式转换。
- 图像生成工具: 集成 Flux API，支持 LLM 生成图像。
- 小宇宙FM 工具: 方便 LLM 下载小宇宙FM播客节目。
MCP 协议支持: 完全兼容 MCP 协议，可以与 Claude Desktop 等 MCP 客户端无缝集成。
可扩展架构: 易于添加新的 API 集成和工具，方便用户根据需求定制功能。
多传输协议支持: 支持 Stdio 和 SSE 等多种传输协议，满足不同应用场景的需求。

安装步骤

推荐使用 'pip' 进行安装，简单快捷：

pip install mcp-toolbox

如果您的环境已经安装了 'uv'，也可以使用 'uv' 进行安装和运行，详情请参考仓库 README。

服务器配置

要将 MCP Toolbox 作为 MCP 服务器与 MCP 客户端（例如 Claude Desktop）连接，您需要在 MCP 客户端中配置服务器的启动命令和参数。

以 Claude Desktop 为例，您需要在 Claude Desktop 的配置文件中添加如下 JSON 配置：

{
  "mcpServers": {
    "zerolab-toolbox": {  //  服务器名称，可以自定义
      "command": "mcp-toolbox",  //  启动服务器的命令，确保 mcp-toolbox 命令在您的 PATH 环境变量中
      "args": ["stdio"],  //  启动参数，这里使用 stdio 传输协议
      "env": {  //  环境变量配置，用于配置各种 API 密钥
        "FIGMA_API_KEY": "your-figma-api-key",  //  Figma API 密钥 (如果使用 Figma 工具)
        "TAVILY_API_KEY": "your-tavily-api-key",  //  Tavily API 密钥 (如果使用 Tavily 搜索工具)
        "DUCKDUCKGO_API_KEY": "your-duckduckgo-api-key",  //  DuckDuckGo API 密钥 (如果使用 DuckDuckGo 搜索工具)
        "BFL_API_KEY": "your-bfl-api-key"  //  Flux Image Generation API 密钥 (如果使用 Flux 图像生成工具)
      }
    }
  }
}

请将上述 JSON 配置添加到您的 Claude Desktop 配置文件中，并根据您需要使用的工具配置相应的 API 密钥。

基本使用方法

启动 MCP Toolbox 服务器: 在命令行中运行以下命令启动 MCP Toolbox 服务器 (使用 stdio 传输协议):

mcp-toolbox stdio

或者使用 SSE 协议 (需要指定 host 和 port):

mcp-toolbox sse --host localhost --port 9871

配置 MCP 客户端: 将上面提供的服务器配置 JSON 添加到您的 MCP 客户端配置文件中 (例如 Claude Desktop)。
连接和使用: 启动 MCP 客户端，客户端将自动连接到 MCP Toolbox 服务器。您可以通过 MCP 客户端指示 LLM 调用 MCP Toolbox 提供的各种工具，例如：
- 让 LLM 读取本地文件内容。
- 让 LLM 执行操作系统命令。
- 让 LLM 访问 Figma 文件并获取设计信息。
- 让 LLM 进行网页搜索并获取信息。
- 让 LLM 生成图像等等。

具体工具的使用方法和参数请参考仓库 README 文档和工具的描述信息。

关键词

使用说明

信息