Aleph MCP Server

使用说明（简明易懂的使用步骤）

• 项目简介
  • Aleph 是一个面向 LLM 的后端服务器，基于 MCP 架构提供资源托管、工具注册与执行、以及 Prompt 渲染与上下文管理等能力。服务器端管理会话、能力声明，并支持多种传输方式，帮助模型高效、可扩展地访问上下文和功能。
• 主要功能点
  • 资源与上下文管理：加载、查看、分块、保存/恢复会话等，避免在提示中注入完整原始上下文。
  • 工具注册与执行：LLM 可通过 MCP 工具调用外部功能（如搜索、执行代码、读取文件等）。
  • Prompt 模板与渲染：定义系统提示与模板化的交互方式，确保与 LLM 的对话在可控的范围内进行。
  • 支持多传输协议：标准的 stdin/stdio、HTTP 传输等，方便与不同类型的 MCP 客户端集成。
  • 会话与安全策略：会话隔离、上下文隔离策略、执行输出的截断与限制、以及基于策略的访问控制。
  • 远程/嵌套子查询：提供 sub_query/sub_aleph 等能力，支持递归/嵌套的子查询工作流。
• 安装步骤
  • 安装依赖并启用 MCP 功能：
    • 通过 Python 包安装：
      • pip install "aleph-rlm[mcp]"
  • 启动 MCP 服务器
    • 使用仓库中提供的默认命令启动（服务器会监听并暴露 MCP 接口，供客户端连接）
• 服务器配置（给 MCP 客户端的参考配置，JSON 格式，包含 server name、command、args 等）
  • 说明：MCP 客户端需要提供服务器名称与启动命令及参数，以便建立连接并对接服务器能力。以下为示例描述信息，实际值请根据环境调整。
  • server name: "aleph"
  • command: 启动Aleph MCP 服务器的可执行命令，例如 "aleph"
  • args: [ "--enable-actions", "--workspace-mode any", "--tool-docs concise" ]
  • 注释：以上参数由 Aleph 提供者/文档中的默认 MCP 配置推断得到，客户端可据此建立连接并使用 Aleph 的 MCP 工具集。若需要自定义工作区、文档展示、或禁用某些工具，可在 config 中调整相应选项。
• 基本使用方式（简单案例）
  • 启动后，在 MCP 客户端的会话中声明需要的资源上下文、调用工具（如 search_context、peek_context、exec_python）以及最终的最终回答（FINAL/FINAL_VAR），服务器将返回标准的 JSON-RPC 风格响应。
  • 常用工作流包括：加载上下文 -> 查询分析 -> 逐步子查询 -> 保存/恢复会话。