使用说明

项目简介

Agentic MCP Client 是一个独立的智能体运行器，它不仅充当 MCP 客户端，能够连接和利用外部 MCP 服务器提供的工具和资源，还嵌入了一个基础的 MCP 服务器功能，主要用于演示和测试目的。此项目旨在帮助开发者构建能够自主执行任务的 AI 智能体，并安全地与各种系统进行交互。它支持多种主流大语言模型 API，包括 Anthropic Claude、AWS Bedrock 和 OpenAI。

主要功能点

独立的智能体运行: 无需外部 MCP 服务器即可运行预定义的智能体任务。
嵌入式 MCP 服务器: 包含基础 MCP 服务器功能，用于演示和测试 MCP 协议的交互。
支持多种模型: 兼容 Anthropic Claude、OpenAI 和 AWS Bedrock 等多种大语言模型。
任务配置化: 通过 JSON 配置文件定义智能体任务和配置。
会话日志记录: 记录智能体运行会话，方便跟踪和调试。
基础仪表盘: 提供一个简单的 Web 仪表盘来监控和管理智能体任务。

安装步骤

克隆仓库

git clone https://github.com/peakmojo/agentic-mcp-client.git
cd agentic-mcp-client

安装依赖
```
uv sync
```

服务器配置

虽然此仓库主要作为 MCP 客户端，并嵌入了基础服务器用于演示，但其配置文件 'config.json' 主要用于配置客户端需要连接的外部 MCP 服务器，以及大语言模型服务。以下是 'config.json' 中 'mcp_servers' 部分的配置示例，用于指定客户端可以连接的外部 MCP 服务器：

{
   "mcp_servers": {
    "mcp-remote-macos-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_username",
        "-e",
        "MACOS_PASSWORD=your_password",
        "-e",
        "MACOS_HOST=your_host_ip",
        "--rm",
        "buryhuang/mcp-remote-macos-use:latest"
      ]
    },
    "mcp-my-apple-remembers": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "-e",
        "MACOS_USERNAME=your_username",
        "-e",
        "MACOS_PASSWORD=your_password",
        "-e",
        "MACOS_HOST=your_host_ip",
        "--rm",
        "buryhuang/mcp-my-apple-remembers:latest"
      ]
    }
  }
}

'mcp_servers': 定义外部 MCP 服务器的字典。
每个服务器配置项使用自定义名称作为键 (例如 '"mcp-remote-macos-use"')。
'command': 启动外部 MCP 服务器的命令，通常是 Docker 命令。
'args': 命令参数列表，用于配置 Docker 容器，例如设置环境变量、指定 Docker 镜像等。

基本使用方法

配置 'config.json': 根据需要配置大语言模型 API 密钥和外部 MCP 服务器连接信息。
创建任务配置文件 'agent_worker_task.json': 定义智能体要执行的任务、使用的模型等参数。
运行智能体: 执行命令 'uv run agentic_mcp_client/agent_worker/run.py' 启动智能体。
访问仪表盘: 在浏览器中访问 'http://localhost:3000' 查看智能体运行状态和会话日志（如果启动了仪表盘）。

关键词