使用说明内容(Markdown格式)

  • 项目简介

    • 该仓库实现了一个基于 MCP 协议的后端服务器,核心功能是对外暴露一个名为 minecontext_screen_context 的工具。该工具内部调用 MineContext 摘要获取逻辑,返回结构化的上下文摘要,便于随后的对话代理或大语言模型(LLM)进行上下文理解和分析。
    • MCP 服务器采用 FastMCP 框架,提供简单的“工具”注册和 JSON 序列化响应能力,方便 MCP 客户端通过标准化 RPC 调用获取 MineContext 摘要。
  • 主要功能点

    • MCP 服务器核心:实现 minecontext_screen_context 工具,通过 MCP 协议向客户端提供 MineContext 摘要。
    • 与 MineContext 集成:内部调用 get_minecontext_summary,获取经过压缩和摘要后的上下文信息。
    • 错误容错:若 MineContext 本地服务不可用,返回标准化的错误结构,确保客户端能够稳定处理异常。
    • 兼容性设计:返回统一的 JSON 结构,方便后续对接 LangChain、Trae 等组件进行进一步分析和决策。
    • 易于部署:以 Python 脚本形式启动 MCP 服务器,结合已有 MineContext 服务即可运行。
  • 安装步骤

    • 先确保系统中已安装 Python 3.x。
    • 安装所需依赖(MCP 框架)。如仓库使用的 mcp 包,请执行相应的包管理命令安装(示例:pip install mcp),确保 FastMCP 可用。
    • 启动 MineContext 本地服务:请确保 MineContext 服务已在 http://127.0.0.1:1733 监听(/contexts 等端点对接)。
    • 启动 MCP 服务器:在仓库目录下运行对应的启动命令,例如执行 minecontext_mcp_server.py(走 FastMCP 的 stdio/网络模式,具体模式由实现决定)。
    • 可选:若该环境中有其它服务(如 Trae、LangChain 等),可将 MineContext 摘要用于后续分析。
  • 服务器配置(MCP 客户端需要的配置信息,JSON 格式) 说明:MCP 客户端需要提供服务器启动信息以便连接。以下信息仅用于描述性配置,实际客户端实现无需代码,仅用于理解配置要点。 { "server_name": "minecontext-server", "command": "python", "args": ["minecontext_mcp_server.py"], "description": "MCP 服务器实现,暴露 minecontext_screen_context 工具,用于获取 MineContext 摘要", "transport": "stdio" // 或其他传输方式,具体由 MCP 框架决定 }

  • 基本使用方法

    • 启动步骤
      1. 启动 MineContext 本地服务,确保其在 http://127.0.0.1:1733 可用。
      2. 启动 MCP 服务器:执行上述服务器启动命令,服务器将监听并处理来自 MCP 客户端的调用。
    • 调用方式(客户端)
      • 通过 MCP 客户端调用 minecontext_screen_context 工具,传入需要的 task_type 与 detail_level 等参数。
      • 服务端返回结构化的 MineContext 摘要,包含 user_intent_summary、recent_activity、tips_summary 等字段,或者返回带有 error 的统一错误结构。
    • 处理与后续
      • 将返回结果用于下游的智能分析、对话代理或对 LLM 的上下文注入,提升对话的上下文相关性与可解释性。

信息

分类

AI与计算