使用说明

项目简介

Headless Agents MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在桥接 Headless Agents API 和支持 MCP 协议的客户端应用，如 Claude Desktop。它允许用户通过 Claude Desktop 直接调用 Headless Agents 提供的各种智能体服务。

主要功能点

将 Headless Agents 的功能封装为 MCP 工具 (Tool) 'call_agent'。
支持通过 Claude Desktop 等 MCP 客户端调用 'call_agent' 工具来请求 Headless Agents 的服务。
通过会话 ID (conversation ID) 支持对话的连续性。
提供错误处理和日志记录，确保服务器的稳定运行。
使用环境变量进行配置，方便部署和管理。

安装步骤

克隆仓库:

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

进入目录:

cd headless-agents-mcp-ts/headless-agents-mcp

安装依赖:
```
npm install
```

配置环境变量: 在 'headless-agents-mcp' 目录下创建 '.env' 文件，并填入您的 Headless Agents API 密钥：

HEADLESS_AGENTS_API_KEY=your_api_key_here

构建并启动服务器:

npm run build && node dist/index.js

服务器配置

要将此 MCP 服务器连接到 Claude Desktop 等 MCP 客户端，您需要在客户端的配置文件中添加以下配置信息。以 Claude Desktop 为例，配置信息通常是 JSON 格式：

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

配置参数说明:

'server name': 'headless-agents' (此名称用于在客户端中标识和调用该服务器提供的工具，例如 'headless-agents.call_agent')
'command': 'node' (启动 MCP 服务器的命令，这里使用 Node.js 运行时环境)
'args':
- '"{path_to_headless-agents-mcp}/dist/index.js"': MCP 服务器入口文件 'dist/index.js' 的路径。 请务必将 '{path_to_headless-agents-mcp}' 替换为您本地 'headless-agents-mcp' 目录的绝对路径。例如，如果您的 'headless-agents-mcp' 目录在 '/Users/yourname/headless-agents-mcp-ts/headless-agents-mcp'，则应替换为 '/Users/yourname/headless-agents-mcp-ts/headless-agents-mcp/dist/index.js'。

基本使用方法

成功配置并启动 MCP 服务器后，您可以在 Claude Desktop 或其他 MCP 客户端中使用 'call_agent' 工具来调用 Headless Agents 的功能。工具的名称格式通常为 '<server name>.<tool name>'，在本例中为 'headless-agents.call_agent'。

例如，在 Claude Desktop 中，您可以使用类似以下的工具调用代码来请求 Headless Agents 执行任务：

{"tool_code": {"tool_name": "headless-agents.call_agent", "parameters": {"agent_id": "your-agent-id", "request": "你好！"}} }

'tool_name': 指定要调用的工具，这里是 'headless-agents.call_agent'。
'parameters': 工具 'call_agent' 接受的参数，包括：
- 'agent_id': 要调用的 Headless Agent 的 ID，请替换为实际的 Agent ID。
- 'request': 发送给 Headless Agent 的请求内容，例如用户的问题或指令。

根据 Headless Agents API 的具体功能和您配置的 Agent，您可以构建不同的 'request' 内容，并通过 'call_agent' 工具在 MCP 客户端中灵活调用 Headless Agents 的能力。

关键词