Headless Agents MCP Server

概述

此服务器允许您将无头代理与 Claude 桌面版集成，通过模型上下文协议(MCP)直接调用无头代理 API。

先决条件

• Node.js v16+
• 从 headlessagents.ai 获取的 API 密钥
• Claude 桌面应用程序

安装步骤

1. 克隆仓库

   git clone https://github.com/headless-agents/headless-agents-mcp-ts.git
   cd headless-agents-mcp-ts
   

2. 安装依赖

   cd headless-agents-mcp && npm install
   

3. 配置环境变量
   在 headless-agents-mcp 目录中创建 .env 文件：

   HEADLESS_AGENTS_API_KEY=your_api_key_here
   

4. 构建并启动服务器

   npm run build && node dist/index.js
   

Claude 桌面版集成

在 Claude 桌面配置文件中添加：

{
    "headless-agents": {
        "command": "node",
        "args": [
            "{path_to_headless-agents-mcp}/dist/index.js"
        ]
    }
}

注意：替换 {path_to_headless-agents-mcp} 为实际安装路径

使用方法

call_agent 工具

调用无头代理的基本语法：

const result = await client.callTool({
  name: "call_agent",
  arguments: {
    agent_id: "agent-id",
    request: "Hey! How are you?",
    conversation_id: "optional-conversation-id" // 可选，用于会话连续性
  }
});

JSON 示例

{
    "agent_id": "agent-id",
    "request": "Hey! How are you?",
    "conversation_id": "optional-conversation-id"
}

功能亮点

• 会话连续性支持
• 全面的错误处理
• 与 Claude 桌面版无缝集成
• 基于环境的配置

服务器启动后，您可以直接在 Claude 桌面应用中使用 call_agent 工具与您的无头代理进行交互。