主持人

emcee是一款工具，可为任何符合OpenAPI规范的 Web 应用程序提供模型上下文协议 (MCP)服务器。您可以使用 emcee 将Claude Desktop和其他应用程序连接到外部工具和数据服务，类似于ChatGPT 插件。

快速入门

如果您使用的是 macOS 并且安装了Homebrew ，则可以快速启动并运行。

# Install emcee
brew install loopwork-ai/tap/emcee

确保您已安装Claude Desktop 。

要配置 Claude Desktop 以便与 emcee 一起使用：

打开 Claude 桌面设置 (⌘,)
选择侧边栏中的“开发者”部分
点击“编辑配置”打开配置文件

配置文件应该位于 Application Support 目录中。您也可以使用以下命令直接在 VSCode 中打开它：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加以下配置以添加 weather.gov MCP 服务器：

{
  "mcpServers": {
    "weather": {
      "command": "emcee",
      "args": [
        "https://api.weather.gov/openapi.json"
      ]
    }
  }
}

保存文件后，退出并重新打开 Claude。您现在应该会在聊天框的右下角看到🔨57。点击它即可查看 Claude 通过 MCP 可以使用的所有工具列表。

开始新的聊天并询问您所在地的天气。

俄勒冈州波特兰的天气怎么样？

Claude 将参考 MCP 提供的工具，如果其中一个工具被认为适合解答您的问题，Claude 将申请使用。您可以审核此请求，并决定批准或拒绝。

如果您允许，Claude 将与 MCP 进行通信并使用结果来通知其响应。

提示：正在构建代理？想要部署远程 MCP 服务器？请联系emcee@loopwork.com

为什么要使用 emcee？

MCP 提供了一种将 AI 模型连接到工具和数据源的标准化方法。虽然目前尚处于早期阶段，但目前已有多种可用于连接浏览器、开发者工具和其他系统的服务器。

我们认为 emcee 是一种便捷的方式，可以连接到尚未实现 MCP 服务器的服务，尤其适用于您自行构建的服务。您有一个符合 OpenAPI 规范的 Web 应用吗？您可能会惊讶地发现，即使没有仪表板或客户端库，您也能取得如此大的进展。

安装

安装程序脚本

使用安装程序脚本下载并安装适合您平台（Linux x86-64/i386/arm64 和 macOS Intel/Apple Silicon）的预构建版本emcee。

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

# bash, zsh
sh <(curl -fsSL https://get.emcee.sh)

自制

使用Loopwork 的 tap中的Homebrew安装 emcee。

brew install loopwork-ai/tap/emcee

Docker

带有 emcee 的预构建Docker 镜像可供使用。

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

从源代码构建

需要1.24或更高版本。

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

一旦构建完成，您就可以就地运行（ ./emcee ）或将其移动到PATH中的某个位置，例如/usr/local/bin 。

用法

Usage:
  emcee [spec-path-or-url] [flags]

Flags:
      --basic-auth string    Basic auth value (either user:pass or base64 encoded, will be prefixed with 'Basic ')
      --bearer-auth string   Bearer token value (will be prefixed with 'Bearer ')
  -h, --help                 help for emcee
      --raw-auth string      Raw value for Authorization header
      --retries int          Maximum number of retries for failed requests (default 3)
  -r, --rps int              Maximum requests per second (0 for no limit)
  -s, --silent               Disable all logging
      --timeout duration     HTTP request timeout (default 1m0s)
  -v, --verbose              Enable debug level logging to stderr
      --version              version for emcee

emcee 为 MCP 实现标准输入/输出 (stdio)传输，使用JSON-RPC 2.0作为其传输格式。

当您从命令行运行 emcee 时，它会启动一个程序，该程序监听 stdin、输出到 stdout 并记录到 stderr。

验证

对于需要身份验证的API，emcee支持多种身份验证方法：

身份验证类型	示例用法	结果标题
持有者令牌	`--bearer-auth="abc123"`	`Authorization: Bearer abc123`
基本身份验证	`--basic-auth="user:pass"`	`Authorization: Basic dXNlcjpwYXNz`
原始值	`--raw-auth="Custom xyz789"`	`Authorization: Custom xyz789`

这些身份验证值可以直接提供，也可以作为1Password 秘密参考提供。

使用 1Password 参考时：

使用格式op://vault/item/field （例如--bearer-auth="op://Shared/X/credential" ）
确保 1Password CLI（ op ）已安装并在您的PATH中可用
在运行 emcee 或启动 Claude Desktop 之前登录 1Password

# Install op
brew install 1password-cli

# Sign in 1Password CLI
op signin

{
  "mcpServers": {
    "twitter": {
      "command": "emcee",
      "args": [
        "--bearer-auth=op://shared/x/credential",
        "https://api.twitter.com/2/openapi.json"
      ]
    }
  }
}

[！重要的]
emcee 从命令参数提供的 URL 下载 OpenAPI 规范时不使用身份验证凭据。如果您的 OpenAPI 规范需要身份验证才能访问，请先使用您首选的 HTTP 客户端将其下载到本地文件，然后将本地文件路径提供给 emcee。

转型 OpenAPI 规范

您可以使用标准 Unix 实用程序转换 OpenAPI 规范，然后再将其传递给 emcee。这适用于：

使用jq或yq选择要公开为工具的特定端点
使用OpenAPI Overlays修改描述或参数
使用Redocly组合多种规格

例如，您可以使用jq仅包含来自weather.gov的point工具。

cat path/to/openapi.json | \
  jq 'if .paths then .paths |= with_entries(select(.key == "/points/{point}")) else . end' | \
  emcee

JSON-RPC

您可以通过发送 JSON-RPC 请求直接与提供的 MCP 服务器进行交互。

emcee 仅提供 MCP 工具功能。其他功能（例如资源、提示和采样）尚不受支持。

列表工具

{"jsonrpc": "2.0", "method": "tools/list", "params": {}, "id": 1}

{
  "jsonrpc":"2.0",
  "result": {
    "tools": [
      // ...
      {
          "name": "tafs",
          "description": "Returns Terminal Aerodrome Forecasts for the specified airport station.",
          "inputSchema": {
              "type": "object",
              "properties": {
                  "stationId": {
                      "description": "Observation station ID",
                      "type": "string"
                  }
              },
              "required": ["stationId"]
          }
      },
      // ...
    ]
  },
  "id": 1
}

呼叫工具

{"jsonrpc": "2.0", "method": "tools/call", "params": { "name": "taf", "arguments": { "stationId": "KPDX" }}, "id": 1}

{
  "jsonrpc":"2.0",
  "content": [
    {
      "type": "text",
      "text": /* Weather forecast in GeoJSON format */,
      "annotations": {
        "audience": ["assistant"]
      }
    }
  ]
  "id": 1
}

调试

MCP 检查器是一款用于测试和调试 MCP 服务器的工具。如果 Claude 和/或 emcee 未按预期工作，检查器可以帮助您了解问题所在。

npx @modelcontextprotocol/inspector emcee https://api.weather.gov/openapi.json
# 🔍 MCP Inspector is up and running at http://localhost:5173 🚀

open http://localhost:5173

执照

emcee 已获得 Apache 许可证 2.0 版的许可。