使用说明
- 项目简介
  - UCAgent MCP Server 基于 MCP（Model Context Protocol）标准，为 LLM 客户端提供资源读取、工具注册与执行、以及 Prompt 模板渲染等上下文服务。服务器端负责会话管理、能力声明，并支持通过 FastMCP 框架暴露工具接口，供客户端调用。
- 主要功能点
  - 资源与数据能力：以工具形式提供对工作区中文件、模板、记忆等资源的访问与管理（如读取、写入、搜索、文件操作等）。
  - 工具注册与执行：将 LangChain 风格的工具适配为 MCP Tool，通过 MCP 客户端调用外部功能实现任务自动化。
  - Prompt/会话管理：整合对话管理与摘要工具，支持多轮对话的上下文维护与总结。
  - MCP 服务暴露：通过 mcp.server.fastmcp 提供 Fast MCP 服务端实现，支持 JSON-RPC 风格的请求/响应。
  - 会话与Telemetry：内置会话追踪、日志、以及可选的 Langfuse 等遥测集成。
- 安装步骤
  - 安装依赖：需要安装 MCP 框架相关依赖、LangChain、uvicorn、以及与 OpenAI/Anthropic 等模型服务的依赖。在本仓库中，相关依赖通过代码导入和运行时加载实现，实际环境中通常通过 pip 安装对应的包。
  - 获取源码：将仓库克隆到本地或服务器上。
  - 安装运行环境依赖后，进入项目根目录。
- 服务器配置（JSON 配置示例）
  - 说明：MCP 客户端需要连接到 MCP 服务器，这里给出一个配置样式，用于 MCP 客户端了解服务器的启动信息与连接参数。实际连接由 MCP 客户端根据该信息发起请求。
  - 配置示例（JSON 结构，含字段含义与注释）： { "server_name": "UCAgent-MCP", "command": "python3", "args": ["-m", "ucagent", "--mcp-server", "--mcp-server-host", "127.0.0.1", "--mcp-server-port", "5000"] } 注释说明：
    - server_name: MCP 服务器的名称，便于标识和日志追踪。
    - command: 启动服务器所用的命令（通常为 Python 运行环境）。
    - args: 启动参数，包含启动 MCP 服务器的子命令与连接参数（示例中使用的参数组合会触发在代码中实现的“start_mcp_server”流程）。
- 基本使用方法
  - 启动服务器：运行上述配置中的启动命令，服务器将启动并对外暴露 MCP 接口。
  - 客户端对接：MCP 客户端通过 JSON-RPC 调用资源读取、工具触发、Prompt 获取等能力，服务器返回 MCP 格式的响应。
  - 运行与监控：服务器支持日志记录、可选的 Langfuse 追踪，便于监控运行状态与性能。

关键词

信息