使用说明

项目简介

Toolhouse MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它充当 MCP 客户端和 Toolhouse 工具平台之间的桥梁。通过此服务器，兼容 MCP 协议的 LLM 客户端（例如 Claude 桌面应用）可以访问 Toolhouse 平台上丰富的工具库，从而增强自身的功能。该服务器利用 Groq API 提供快速的推理能力。

主要功能点

工具集成: 允许 MCP 客户端访问 Toolhouse 平台上的各种工具，例如网页抓取、记忆功能、发送邮件等。
标准化协议: 基于 MCP 协议，确保与各种兼容 MCP 协议的 LLM 客户端无缝集成。
易于配置: 通过简单的环境变量配置 Toolhouse API 密钥和工具包 (Bundle)。

安装步骤

克隆仓库

git clone https://github.com/toolhouse-community/mcp-server-toolhouse.git
cd mcp-server-toolhouse

安装依赖 虽然文档中没有明确提及，但根据 Python 项目的常见实践，可能需要创建虚拟环境并安装依赖。通常可以使用 'uv' 或 'pip'：
```
# 使用 uv (如果已安装)
uv pip install .
# 或者使用 pip
pip install .
```
请注意，实际安装步骤可能需要参考项目更详细的文档或构建脚本（如果存在）。

服务器配置

要将此 MCP 服务器添加到 MCP 客户端，您需要配置客户端的 MCP 服务器设置。以下是 Claude 桌面应用等客户端的配置示例，您需要根据您的客户端进行相应的配置。

配置示例 (以 UV 运行):

以下 JSON 配置需要添加到 MCP 客户端的配置文件中（例如 Claude 桌面应用的 'claude_desktop_config.json'）。

{
  "mcpServers": {
    "toolhouse": {  // 服务器名称，客户端内唯一标识即可
      "command": "uv",  // 运行服务器的命令，这里假设使用 uv 运行
      "args": [
        "--directory",  // 指定工作目录
        "/path/to/this/repo/", //  替换为 mcp-server-toolhouse 仓库的实际路径
        "run",          // uv 的子命令，表示运行
        "mcp-server-toolhouse" //  运行的模块名或脚本名，对应项目中的 mcp_server_toolhouse 模块
      ],
      "env": {
        "TOOLHOUSE_API_KEY": "your_toolhouse_api_key",  // 你的 Toolhouse API 密钥，**必须替换为实际密钥**
        "TOOLHOUSE_BUNDLE": "a_bundle_name"  // 你在 Toolhouse 平台创建的工具包名称，**必须替换为实际工具包名称**
      }
    }
  }
}

重要环境变量配置：

在启动 MCP 服务器之前，您需要设置以下环境变量：

'TOOLHOUSE_API_KEY': 您的 Toolhouse API 密钥。您需要在 Toolhouse 官网注册并创建账号以获取 API 密钥。
'TOOLHOUSE_BUNDLE': 您在 Toolhouse 平台上创建的工具包 (Bundle) 的名称。您需要在 [Toolhouse Bundles](此处文档中链接缺失，请用户自行在 Toolhouse 平台查找 "Bundles" 或 "工具包" 相关页面) 页面创建工具包，并将您希望在客户端中使用的工具添加到该工具包中。

您可以选择将这些环境变量直接添加到客户端的 JSON 配置文件中 ('env' 字段)，或者在运行 MCP 客户端的环境中设置全局环境变量。

基本使用方法

启动 MCP 服务器: 根据客户端的配置，客户端启动时会自动尝试连接并启动配置的 MCP 服务器。如果使用 'uv' 运行，并且配置正确，客户端应该能够成功启动 Toolhouse MCP Server。
在客户端中使用工具: 一旦 MCP 服务器成功连接，客户端应该能够检测到由 Toolhouse MCP Server 提供的工具。具体使用方式取决于 MCP 客户端的界面和功能，通常您可以在客户端的工具列表或功能菜单中找到并调用这些工具。
Toolhouse 平台管理: 您可以在 Toolhouse 平台上管理您的工具包 (Bundle)，添加、删除或配置工具，这些更改会反映到通过 Toolhouse MCP Server 连接的 MCP 客户端。

调试

如果遇到连接或工具使用问题，可以参考文档中提到的 MCP Inspector 进行调试。

关键词