ATaC MCP Server

关键词

AI上下文服务工具执行轨迹管理记忆模块工作流管理

使用说明书（Markdown 格式）

  • 项目简介

    • ATaC MCP Server 是一个用于将 ATaC 轨迹管理与执行能力暴露为 MCP 服务端的实现。它通过 MCP Server 框架暴露一组工具、提示模板及资源管理能力，供 MCP 客户端调用，以实现向大型语言模型提供标准化的上下文信息和能力服务。

  • 主要功能点

    • 注册并暴露 MCP Tool：通过装饰器将 ATaC 的操作（如创建工作区、添加输入/变量、添加动作、读取/导出等）注册为 MCP 工具，供客户端远程调用。
    • 提供内置的 MCP Server 指令与查询：如初始化工作区、查看工作区、显示工作流结构、读取内存等。
    • 内置内存模块的 MCP 服务：提供 memory Save/List/Read/Search/Delete 等工具，支持以内存 Bundle 的形式持久化并复用记忆片段。
    • Prompts、Schema 等资源支持：提供 atac_instructions 与 atac_schema 等资源，便于客户端获取使用说明和数据结构定义。
    • 运行与配置分离：服务器通过 mcp server 框架接收请求，运行所需的 ATaC 逻辑，并返回 JSON-RPC 风格的响应。

  • 安装步骤

    • 确保环境：安装 Python 3.8+（或仓库要求版本），并安装所需的 Python 包（MCP 框架及其依赖）。
    • 启动方式（两种常用）：
      • 直接运行服务器模块：在仓库根目录执行 python -m atac.mcp.server（或等效入口），启动 ATaC 的 MCP 服务端。
      • 通过 MCP 客户端接入方式运行内存 MCP：在需要内存记忆服务的场景，启动 python -m atac.mcp.memory_server。
    • 配置 MCP 服务器环境变量或配置文件：
      • 通过环境变量 ATAC_MCP_SERVER_CONFIGS 指定 MCP 服务器配置文件路径，示例：ATAC_MCP_SERVER_CONFIGS=path/to/mcp_config.json
      • 也可以在本地 .atac/atac.json 中配置 mcp_config，作为最高优先级加载项。
    • 运行注意事项：确保配置文件中的服务器名称、命令、参数与环境变量正确设置，服务器运行时会创建并维护对外暴露的工具。

  • 服务器配置（供 MCP 客户端参考，实际客户端客户端不需要实现代码）

    • 使用 MDC（MCP 客户端需要的配置信息）时，配置应包含：
      • server 名称 atac，执行命令 emprecord：command 为 uvx，args 为 ["atac", "mcp"]，并通过环境变量 ATAC_MCP_SERVER_CONFIGS 指向 JSON/YAML 配置文件的路径列表。
      • memory-mcp 服务（可选） atac-memory，执行命令为 uvx，args 为 ["atac", "memory-mcp", "--memory-dir", "<记忆目录>"]。
    • 注意：以上配置信息用于 MCP 客户端对接服务端的方式，实际客户端使用没有必要关心服务端实现细节。

  • 基本使用方法

    • 启动服务端后，MCP 客户端可以按照 MCP 标准向 ATaC Server 发送请求，调用注册的工具（例如初始化、添加输入、添加动作、读取工作区等），以及请求内存相关服务。
    • 客户端可以通过调用 atac_init、atac_add_input、atac_add_action 等工具来对工作区进行操作，服务端将返回执行结果或状态信息。
    • 针对内存相关操作（memory 模块），通过 memory_save/memory_list/memory_read/memory_search/memory_delete/memory_run_command 等工具进行管理和查询。
    • 如需获取使用说明和工作流结构，请通过 atac_instructions 与 atac_schema 资源获取相应内容。

  • 进一步实践要点

    • 你可以将 ATaC 的工作区导出为 JSON/YAML，通过 MCP 客户端对接后将其融入到更大规模的 AI 工作流中，以实现统一的上下文服务和工具执行能力。

服务器信息

访问项目