关键词

API集成AI代理大模型工具自动化Google Workspace

项目简介

Automagik Tools 是一个基于 Model Context Protocol (MCP) 的强大工具包，旨在弥合传统API与智能AI代理之间的鸿沟。它允许您无需编写代码，即可将现有API、本地文件系统甚至SaaS应用（如Google Drive、Sheets、Docs）转换为AI可理解和调用的工具（Tools）和资源（Resources）。通过标准化的JSON-RPC协议，Automagik Tools 服务器能与各种MCP客户端（如Claude Code、Cursor、Gemini CLI等）通信，赋能AI代理以自然语言与您的系统交互、执行任务。

主要功能点

  • API快速转AI代理: 仅需OpenAPI规范URL，即可在30秒内将任何API转换为智能AI代理，支持自然语言交互。
  • 智能工具编排 (Genie): 核心的“Genie”元代理能够协调多个MCP服务器，具备持久化记忆能力，让AI代理能够学习您的偏好和工作流。
  • 多传输协议支持: 支持stdio（本地CLI）、SSE（团队共享）和HTTP（API集成）等多种通信协议，灵活适应不同部署场景。
  • 内置工具: 提供包括Google Drive、Google Sheets、Google Docs、WhatsApp自动化、Automagik Suite集成等一系列开箱即用的MCP工具。
  • 插件式架构: 允许轻松创建和集成自定义工具，扩展功能。
  • AI增强处理: 利用GPT-4.1-nano等模型，将API返回的复杂JSON数据转换为简洁易读的Markdown格式。

安装步骤

前置条件

  • Python 3.12+
  • OpenAI API Key (用于AI智能增强功能)
  • 您希望集成的API的OpenAPI规范（如果是通过'openapi'命令创建动态工具）

推荐安装方式 (无需全局安装)

使用 'uvx' 工具运行，它会自动下载并运行最新版本的 'automagik-tools'，无需预先安装：

uvx automagik-tools list

全局安装方式 (可选)

如果您希望全局安装，可以使用pip：

pip install automagik-tools

安装后，可以直接使用 'automagik-tools' 命令。

服务器配置 (用于MCP客户端)

MCP客户端需要配置启动Automagik Tools服务器的命令。以下是几种常见配置示例（JSON格式），您可以根据实际需求进行修改，并将其放置在您的MCP客户端的配置中（例如，Cursor的 '~/.cursor/mcp.json' 或 Claude Code 的设置）：

1. 启动完整的Automagik Tools Hub (SSE 模式，推荐用于团队共享)

{
  "mcpServers": {
    "automagik-tools-hub-sse": {
      "command": "uvx",
      "args": [
        "automagik-tools@latest",
        "hub",
        "--transport",
        "sse",
        "--host",
        "0.0.0.0",
        "--port",
        "8884"
      ],
      "env": {
        "OPENAI_API_KEY": "您的OpenAI API Key",
        "AUTOMAGIK_API_KEY": "如果您使用Automagik Suite，请填写API Key",
        "AUTOMAGIK_BASE_URL": "Automagik Suite基础URL",
        "GOOGLE_OAUTH_CLIENT_ID": "如果您使用Google工具，请填写Google OAuth Client ID",
        "GOOGLE_OAUTH_CLIENT_SECRET": "如果您使用Google工具，请填写Google OAuth Client Secret",
        "GOOGLE_MCP_CREDENTIALS_DIR": "Google凭据存储目录，例如: /home/user/.mcp-credentials",
        "USER_GOOGLE_EMAIL": "用于Google服务的用户邮箱"
      },
      "description": "提供所有Automagik工具的智能中枢，支持SSE连接"
    }
  }
}
  • 注释:
    • 'automagik-tools-hub-sse': 服务器的名称，您可以在MCP客户端中识别。
    • 'command': 启动 'uvx' 工具来运行 'automagik-tools'。
    • 'args': 启动 'hub' 命令，指定 'sse' 传输协议，并监听所有网络接口的'8884'端口。
    • 'env': 环境变量用于配置AI功能（如OpenAI API Key）和各种内置工具的凭据。请根据您使用的工具替换为实际值。
    • 'description': 服务器的简要描述。

2. 启动特定工具 (例如，Google Drive，stdio 模式，推荐用于本地开发)

{
  "mcpServers": {
    "google-drive-local": {
      "command": "uvx",
      "args": [
        "automagik-tools@latest",
        "tool",
        "google-drive",
        "--transport",
        "stdio"
      ],
      "env": {
        "OPENAI_API_KEY": "您的OpenAI API Key",
        "GOOGLE_OAUTH_CLIENT_ID": "您的Google OAuth Client ID",
        "GOOGLE_OAUTH_CLIENT_SECRET": "您的Google OAuth Client Secret",
        "GOOGLE_MCP_CREDENTIALS_DIR": "Google凭据存储目录，例如: /home/user/.mcp-credentials",
        "USER_GOOGLE_EMAIL": "用于Google Drive服务的用户邮箱"
      },
      "description": "提供Google Drive文件管理功能的本地MCP服务器"
    }
  }
}
  • 注释:
    • 'google-drive-local': 服务器的名称。
    • 'command': 启动 'uvx' 工具来运行 'automagik-tools'。
    • 'args': 启动 'tool' 命令，指定 'google-drive' 工具和 'stdio' 传输协议。
    • 'env': 用于Google Drive工具所需的环境变量。
    • 'description': 服务器的简要描述。

3. 启动动态OpenAPI工具 (例如，Stripe API，stdio 模式)

{
  "mcpServers": {
    "stripe-api": {
      "command": "uvx",
      "args": [
        "automagik-tools@latest",
        "openapi",
        "https://api.stripe.com/openapi.json",
        "--transport",
        "stdio",
        "--api-key",
        "您的Stripe API Key"
      ],
      "env": {
        "OPENAI_API_KEY": "您的OpenAI API Key"
      },
      "description": "通过Stripe OpenAPI规范动态生成的MCP服务器"
    }
  }
}
  • 注释:
    • 'stripe-api': 服务器名称。
    • 'command': 启动 'uvx' 工具来运行 'automagik-tools'。
    • 'args': 启动 'openapi' 命令，并提供Stripe的OpenAPI规范URL。'--api-key' 参数用于传递API密钥。
    • 'env': 同样需要OpenAI API Key用于AI增强。
    • 'description': 服务器的简要描述。

基本使用方法

  1. 启动服务器:
    • 启动所有工具的中心枢纽 (推荐): 
      # 默认SSE模式，端口8884，监听所有接口
uvx automagik-tools hub --transport sse --host 0.0.0.0 --port 8884
      这会在后台启动一个包含所有内置和动态生成工具的MCP服务器。
    • 启动单个工具 (例如，Google Drive): 
      # 本地stdio模式
uvx automagik-tools tool google-drive --transport stdio
      这会启动一个仅提供Google Drive功能的MCP服务器。
    • 从OpenAPI规范创建动态工具 (例如，Discord API): 
      # Discord API，默认stdio模式
uvx automagik-tools openapi https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json --api-key YOUR_DISCORD_TOKEN_HERE
      这会根据Discord的OpenAPI规范动态创建一个MCP工具。
  2. 配置MCP客户端:
    • 根据上述“服务器配置”部分，将相应的JSON配置添加到您的MCP客户端（例如Claude Code、Cursor）的设置中。
  3. 通过AI代理交互:
    • 在您的MCP客户端中，选择Automagik Tools服务器。
    • 使用自然语言向AI代理提问或下达指令。例如：
      • "在我的Google Drive中搜索所有名为'Meeting Notes'的文档。" (调用 'google_drive_search_drive_files' 工具)
      • "创建一个标题为'项目周报'的Google Docs文档。" (调用 'google_docs_create_doc' 工具)
      • "显示Stripe上最近失败的支付。" (调用通过OpenAPI生成的Stripe工具)
  4. AI学习与适应:
    • 随着您的使用，Genie代理会学习您的交互模式、数据偏好，并优化响应。

信息

分类

开发者工具

访问项目