项目简介

AgentCraft MCP Server 是 Crafted™ 公司的 AgentCraft 产品的配套组件,它作为一个 Model Context Protocol (MCP) 服务器,旨在为 AI Agent 提供安全、可扩展的上下文服务框架。该服务器允许 AI Agent 安全地交互和交换数据,并支持预制和自定义的 AI Agent,适用于企业级应用。

主要功能点

  • 安全通信与数据交换: 为 AI Agent 提供安全的通信渠道和数据交换机制。
  • 支持多种 Agent: 兼容预制和自定义的 AI Agent,满足不同业务需求。
  • 企业级架构: 具备可扩展性和企业级稳定性,适用于生产环境。
  • 工具集成: 支持通过工具扩展 Agent 的能力,例如数据处理、外部API调用等。
  • 会话管理: 服务器端负责管理 Agent 会话,保持上下文连贯性。
  • 标准 MCP 协议: 遵循 MCP 协议标准,易于与兼容 MCP 客户端集成。

安装步骤

  1. 使用 pip 安装 (推荐):

    pip install agentcraft-mcp
  2. 使用 pip 本地安装:

    pip install -e .

    安装后,可以通过以下命令运行服务器:

    python -m agentcraft_mcp.server

服务器配置

AgentCraft MCP Server 需要配置在 MCP 客户端中才能使用。以下是 Claude Desktop 客户端的配置示例,其他 MCP 客户端的配置方式类似。

Claude Desktop 配置 (claude_desktop_config.json):

{
  "mcpServers": {
      "AgentCraft": {
          "command": "python",
          "args": [
              "-m",
              "agentcraft_mcp.server"
          ],
          "env": {
              "AGENTCRAFT_BEARER_TOKEN": "Your AgentCraft Bearer Token for authorization",
              "ENVIRONMENT": "PRODUCTION"
          }
      }
  }
}

配置参数说明:

  • server name (AgentCraft): 服务器名称,可以自定义,用于在客户端中标识和选择服务器。
  • command (python): 启动服务器的命令,这里使用 'python' 解释器。
  • args (["-m", "agentcraft_mcp.server"]): 传递给 'python' 命令的参数,用于指定运行 'agentcraft_mcp.server' 模块来启动服务器。
  • env (环境变量): 配置服务器运行所需的环境变量:
    • AGENTCRAFT_BEARER_TOKEN: AgentCraft 授权令牌,用于服务器鉴权,请替换为您的实际 Token
    • ENVIRONMENT: 运行环境,可选 'PRODUCTION' 或其他值 (默认为开发环境)。

注意: 请确保已安装 Python 环境,并将 'AGENTCRAFT_BEARER_TOKEN' 环境变量设置为您的有效令牌。

基本使用方法

  1. 启动服务器: 根据安装步骤配置并启动 AgentCraft MCP Server。

  2. 配置 MCP 客户端: 在 MCP 客户端(如 Claude Desktop)中添加上述服务器配置。

  3. 客户端连接服务器: 在客户端中选择配置的 "AgentCraft" 服务器,建立连接。

  4. 使用工具: 客户端可以通过 MCP 协议调用服务器提供的工具,例如:

    • 'send_agent_data': 发送数据给 Agent。
    • 'receive_agent_data': 从 Agent 接收数据。
    • 'get_available_agents': 获取可用 Agent 列表。

    具体工具的使用方法和参数,请参考仓库 'README.md' 文件中 "Available Tools" 部分的说明。

信息

分类

AI与计算