使用说明

项目简介

Toolhouse MCP服务器是一个基于Model Context Protocol (MCP) 的服务器实现，它作为LLM客户端和 Toolhouse 平台之间的桥梁。通过这个服务器，LLM客户端可以发现并调用Toolhouse平台上丰富的工具，从而扩展自身的功能边界。

主要功能点

工具发现: LLM客户端可以通过MCP协议向Toolhouse MCP服务器请求可用的工具列表。服务器会从Toolhouse平台动态获取工具信息并返回给客户端。
工具调用: LLM客户端可以请求Toolhouse MCP服务器执行特定的工具。服务器会将请求转发到Toolhouse平台执行，并将执行结果返回给客户端。
作为桥梁: Toolhouse MCP服务器本身不托管工具或资源，它充当一个代理，将LLM客户端的工具使用需求转发到Toolhouse平台，并返回结果。

安装步骤

本仓库的代码可以直接运行，但它主要作为连接Toolhouse平台的桥梁，你需要确保已经拥有Toolhouse平台的账号和API Key。

1. 环境准备

确保你的环境中安装了Python和pip。建议使用Python 3.8 或更高版本。

2. 安装依赖

在仓库根目录下，打开终端并执行以下命令安装所需的Python库：

pip install -e .

或者，如果你想手动安装依赖，可以执行：

pip install mcp-server httpx

3. 设置环境变量

Toolhouse MCP服务器需要以下环境变量才能正常工作：

'TOOLHOUSE_API_KEY': 你的Toolhouse平台API Key。这是访问Toolhouse平台工具的关键凭证。请替换为你自己的API Key。
'TOOLHOUSE_BUNDLE': Toolhouse平台上的工具Bundle名称。Bundle是工具的集合，你需要指定要使用的工具Bundle名称。

你可以通过多种方式设置环境变量，例如在终端中 export 命令，或者在运行脚本前设置。

4. 运行服务器

在仓库根目录下，打开终端并执行以下命令启动Toolhouse MCP服务器：

python -m src.mcp_toolhouse

服务器默认使用标准输入/输出 (stdio) 进行通信。

服务器配置

以下是MCP客户端连接Toolhouse MCP服务器所需的配置信息（JSON格式）：

{
    "mcpServers": {
        "MCP-Toolhouse": {  // 服务器名称，客户端用于标识和选择服务器
            "command": "python", // 启动服务器的命令，这里是python解释器
            "args": ["-m", "src.mcp_toolhouse"], // 启动参数，指定运行 mcp_toolhouse 模块
            "env": { // 环境变量配置
                "TOOLHOUSE_API_KEY": "th-******************_*****_******************", // Toolhouse API Key，请替换为你自己的API Key
                "TOOLHOUSE_BUNDLE": "toolhouse-bundle-name", // Toolhouse 工具Bundle名称，请替换为你希望使用的Bundle名称
                "PYTHONUTF8": "1" // (可选) 某些工具可能需要在Windows上设置 PYTHONUTF8=1 以支持UTF-8编码
            }
        }
    }
}

配置说明:

'server name' (MCP-Toolhouse): 为这个MCP服务器实例指定一个名称，客户端会使用这个名称来识别和连接服务器。你可以自定义这个名称。
'command' (python): 指定启动服务器程序的可执行命令。这里使用 'python' 命令来运行Python脚本。
'args' (["-m", "src.mcp_toolhouse"]): 传递给 'command' 的参数。'-m src.mcp_toolhouse' 告诉Python运行 'src/mcp_toolhouse/main.py' 模块 (由于 'init.py' 中有 'if name == "main":' 块，直接运行 'src.mcp_toolhouse' 模块即可启动服务器)。
'env' (环境变量): 配置服务器运行时需要的环境变量。
- 'TOOLHOUSE_API_KEY': 必须配置。替换为你在Toolhouse平台获得的API Key。
- 'TOOLHOUSE_BUNDLE': 必须配置。替换为你要使用的Toolhouse工具Bundle的名称。
- 'PYTHONUTF8': 可选配置。在Windows系统上，如果遇到编码问题，可以尝试设置 'PYTHONUTF8=1'。

请注意: 你需要将 '"th-__***"' 替换为你真实的Toolhouse API Key，并将 '"toolhouse-bundle-name"' 替换为你想要使用的Toolhouse工具Bundle名称。

基本使用方法

确保Toolhouse MCP服务器已成功启动并运行。
在你的MCP客户端中，配置上述提供的JSON配置信息，添加 "MCP-Toolhouse" 服务器。
客户端连接到 "MCP-Toolhouse" 服务器后，可以向服务器发送MCP协议请求，例如：
- 请求列出可用工具 (ListToolsRequest)。服务器会返回Toolhouse平台上可用的工具列表。
- 请求调用特定工具 (CallToolRequest)。客户端需要指定工具名称和参数，服务器会将请求转发到Toolhouse平台执行，并返回结果。

通过Toolhouse MCP服务器，你的LLM应用可以方便地利用Toolhouse平台提供的各种工具，例如搜索、计算、数据分析等，从而增强LLM的功能和应用场景。

关键词