OpenAPI Transformer

🚀 emcee 中文翻译

emcee 是一款服务于 MCP 协议 的工具，其核心功能在于提供并管理各类工具。而且，它支持借助 OpenAPI 定义的接口来拓展工具集。

🚀 快速开始

基本命令

• 列出所有工具：

emcee tools/list

• 调用特定工具：

emcee tools/call --name tool_name --arguments '{"argument_key": "argument_value"}'

✨ 主要特性

• 支持通过 OpenAPI 定义的接口扩展工具集。
• 提供 MCP 功能，可通过多种方式安装。
• 支持 Docker 安装。
• 有完善的配置文件机制。
• 具备 JSON - RPC 接口。
• 提供调试工具。

📦 安装指南

1. 使用 emcee 提供 MCP 功能

• 安装方式：
  • 下载并解压 最新版本。
  • 按照终端中的说明进行操作。
• 验证安装：

emcee --version

2. 使用 Docker 安装

docker pull loopworkai/emcee:latest

💻 使用示例

基础用法

列出工具

emcee tools/list

调用特定工具

emcee tools/call --name tool_name --arguments '{"argument_key": "argument_value"}'

高级用法

指定配置文件运行

emcee --config /path/to/config.yaml tools/list

📚 详细文档

配置文件

• 创建配置文件（默认路径为 $HOME/.config/emcee/config.yaml）：

log_level: info
cache_dir: $HOME/.cache/emcee

• 指定配置文件运行：

emcee --config /path/to/config.yaml tools/list

开发环境

克隆仓库

git clone https://github.com/loopwork-ai/emcee.git
cd emcee

安装依赖

go mod tidy

运行测试

go test ./...

深入理解

OpenAPI 支持

• OpenAPI 文件结构：

openapi: "3.0"
info:
  title: Example API
  version: 1.0.0
paths:
  /example:
    get:
      summary: Returns a list of examples.
      responses:
        '200':
          description: Successfully retrieved examples.

• 工具定义：

tools:
  - name: example_tool
    description: 描述示例工具的功能。
    input_schema:
      type: object
      properties:
        input_key:
          type: string

JSON - RPC 接口

• 请求格式：

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "example_tool",
    "arguments": {
      "input_key": "input_value"
    }
  },
  "id": 1
}

• 响应格式：

{
  "jsonrpc": "2.0",
  "result": {
    "content": [
      {
        "type": "text/plain",
        "text": "响应内容"
      }
    ]
  },
  "id": 1
}

调试工具

MCP 检查器

• 安装：

npm install -g @modelcontextprotocol/inspector

• 使用：

emcee-inspector emcee --port 5173

• 访问地址：http://localhost:5173

📄 许可证

emcee 采用 Apache License, Version 2.0 许可证。