Aipolabs Mcp Unified

Aipolabs Mcp Unified

未知

概述

本指南介绍如何使用 Model Context Protocol (MCP) 服务器访问 ACI.dev 的函数工具。提供两种服务器类型:

  • 应用服务器:直接访问指定应用的函数
  • 统一服务器:通过元函数发现和执行平台上的所有功能

前提条件

  1. 获取 ACI.dev API 密钥并设置环境变量:
    export AIPOLABS_ACI_API_KEY=your_api_key
    
  2. platform.aci.dev 配置应用
  3. 获取您的 linked-account-owner-id

安装

# 安装依赖
curl -sSf https://install.pypa.io/get-pip.py | python3 -
pip install uv

使用方法

应用服务器(特定应用访问)

# 基本用法
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <YOUR_ID>

# 高级用法(自定义传输和端口)
uvx aipolabs-mcp apps-server --apps "BRAVE_SEARCH,GMAIL" --linked-account-owner-id <YOUR_ID> --transport sse --port 8000

统一服务器(动态工具发现)

# 访问所有可用函数
uvx aipolabs-mcp unified-server --linked-account-owner-id <YOUR_ID>

# 仅限于您可访问的函数
uvx aipolabs-mcp unified-server --linked-account-owner-id <YOUR_ID> --allowed-apps-only

客户端配置

Claude Desktop

claude_desktop_config.json 中添加:

{
  "mcpServers": {
    "aipolabs-mcp-unified": {
      "command": "uvx",
      "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<YOUR_ID>"]
    }
  }
}

Cursor

mcp.json 中添加:

{
  "mcpServers": {
    "aipolabs-mcp-unified": {
      "command": "uvx",
      "args": ["aipolabs-mcp", "unified-server", "--linked-account-owner-id", "<YOUR_ID>"],
      "env": {
        "AIPOLABS_ACI_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

调试

使用 MCP 检查器测试服务器:

npx @modelcontextprotocol/inspector uvx aipolabs-mcp unified-server --linked-account-owner-id <YOUR_ID>

两种服务器类型对比

  • 应用服务器:直接暴露特定应用的工具,适合只需要少量特定工具的场景
  • 统一服务器:提供两个元函数(搜索和执行),动态发现和使用任何可用工具,避免上下文窗口过载

详细文档请访问 ACI.dev 文档