使用说明

项目简介

Emcee 是一个桥梁，连接了通过 OpenAPI 规范描述的 Web API 和使用 Model Context Protocol (MCP) 的 AI 模型。它允许您快速将现有 Web 应用程序的功能公开为 AI 模型（如 Claude）可以理解和利用的工具。

主要功能点

• 将 OpenAPI 规范转换为 MCP 兼容的工具。
• 支持基于标准输入/输出 (stdio) 的 JSON-RPC 通信。
• 提供工具列表和工具调用功能。
• 支持多种身份验证方式（Bearer Token, Basic Auth, Raw Value）。
• 提供多种安装选项，方便用户快速部署 (Homebrew, Docker, 安装脚本, 从源码构建)。

安装步骤

您可以选择以下任一方式安装 Emcee：

• 使用 Homebrew (macOS):

  brew install loopwork-ai/tap/emcee
  

• 使用安装脚本:

  sh <(curl -fsSL https://get.emcee.sh)
  

  或者 (for fish shell):

  sh (curl -fsSL https://get.emcee.sh | psub)
  

• 使用 Docker:

  docker run -it ghcr.io/loopwork-ai/emcee
  

• 从源码构建 (需要 Go 环境):

  git clone https://github.com/loopwork-ai/emcee.git
  cd emcee
  go build -o emcee cmd/emcee/main.go
  

  构建完成后，请确保 'emcee' 可执行文件位于您的 'PATH' 环境变量中。

服务器配置

要将 Emcee 配置为 MCP 服务器供 MCP 客户端使用（例如 Claude Desktop），您需要在 MCP 客户端的配置文件中指定 Emcee 的启动命令及其参数。

以 Claude Desktop 为例，您需要在 'claude_desktop_config.json' 文件中添加如下配置：

{
  "mcpServers": {
    "your_server_name": { // "your_server_name" 可以自定义，作为您的服务器名称，例如 "my_api_tools"
      "command": "emcee",
      "args": [
        "path/to/your/openapi.json" // 这里填写您的 OpenAPI 规范文件路径，可以是本地文件路径，例如 "openapi.json"，也可以是 URL，例如 "https://your-api.com/openapi.json"
      ]
    }
  }
}

注意: 请将 '"path/to/your/openapi.json"' 替换为您实际的 OpenAPI 规范文件路径或 URL。'"your_server_name"' 可以替换为您自定义的服务器名称。

基本使用方法

1. 安装 Emcee (选择上述任一安装方式)。
2. 配置 MCP 客户端 (例如 Claude Desktop)，指定 'emcee' 命令和 OpenAPI 规范路径/URL 作为参数。
3. 启动 MCP 客户端 (例如 重启 Claude Desktop)。
4. 与 AI 模型交互，模型现在可以利用您 OpenAPI 规范中定义的工具。 例如，您可以询问 Claude 天气，如果您的 OpenAPI 规范中包含了天气 API，Claude 就可以通过 Emcee 调用该 API 并回答您的问题。