Headless Agents MCP Server

基本能力

产品定位

Headless Agents MCP Server 是一个中间件服务，旨在桥接 Headless Agents API 和 Claude Desktop 应用，提供高效的自动化对话和任务处理能力。

核心功能

• 与 Claude Desktop 的无缝集成
• 通过对话 ID 支持对话连续性
• 错误处理和日志记录
• 基于环境的配置管理

适用场景

• 在 Claude Desktop 中自动化调用 Headless Agents
• 需要持续对话的自动化任务
• 需要集成 Headless Agents API 的开发项目

工具列表

call_agent

调用 Headless Agent 并发送请求。

参数: - agent_id (string): 要调用的 Agent ID - request (string): 发送给 Agent 的请求消息 - conversation_id (string, 可选): 用于持续对话的可选对话 ID

使用教程

使用依赖

• Node.js (v16 或更高版本)
• Headless Agents API key (从 headlessagents.ai 获取)
• Claude Desktop 应用

安装教程

1. 克隆仓库:

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

1. 安装依赖:

cd headless-agents-mcp && npm install

1. 创建 .env 文件:

HEADLESS_AGENTS_API_KEY=your_api_key_here

1. 构建并启动服务器:

npm run build && node dist/index.js

调试方式

• 检查 .env 文件中的 API key 是否正确
• 确保 Node.js 版本符合要求
• 查看服务器日志以排查错误

与 Claude Desktop 集成

在 Claude Desktop 配置文件中添加以下配置:

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

将 {path_to_headless-agents-mcp} 替换为安装目录的绝对路径。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。