使用说明内容（Markdown格式）

• 项目简介

  • 该仓库实现了一个以 MCP 协议为核心的计算型 MCP 服务器，核心组件为 CalculationMCPServer，提供对工具的注册、执行、状态查询与结果获取的能力，并支持通过 SSE 传输与客户端通信。

• 主要功能点

  • 工具管理：注册、封装并暴露计算工具给 MCP 客户端使用，支持异步执行与结果聚合。
  • 作业调度与执行：将工具调用转换为可执行的作业，提供提交、查询、终止与结果获取等完整流程。
  • 数据与 artefact 管理：在作业执行过程中处理输入输出 artefacts 的上传/下载、版本管理与权限控制。
  • 传输协议支持：内置对 SSE 的支持，方便客户端通过 JSON-RPC 与服务器交互。
  • 会话与上下文管理：通过 MCP 的上下文与作业上下文进行日志记录、错误处理与状态追踪。

• 安装步骤

  • 获取源码后，安装依赖（该项目的 setup 配置包含所需包，例如 mcp、aiohttp、fastapi 等）。
  • 进入示例目录执行服务器（示例脚本使用 CalculationMCPServer 并以 SSE 作为传输协议启动服务）：
    • python3 examples/calculation/server.py
  • 如需自定义运行参数，请参考 CalculationMCPServer 的初始化参数及 examples/calculation/server.py 的调用方式。

• 服务器配置

  • MCP 客户端在连接服务器前通常需要提供配置（server name、command、args 等信息），以 JSON 格式描述用于启动服务器的命令信息（服务器端口、主机、运行模式等由 MCP 客户端管理，不需要源码中包含暴露的客户端配置）。
  • 示例配置（仅为说明，不是直接执行代码）： { "server_name": "CalculationMCPServer", "command": "python3", "args": ["path/to/examples/calculation/server.py"] // 说明：server_name 对应服务器标识，command/args 为启动服务器的命令及参数 }

• 基本使用方法

  • 启动服务器后，客户端可以通过 MCP JSON-RPC 方式向服务器提交工具调用、查询作业状态、获取结果等，服务器将返回标准的 MCP JSON-RPC 响应。
  • 常见工作流：
    • 注册工具到 MCP 服务器
    • 提交计算任务（包含输入数据路径、模型参数等）
    • 查询任务状态，直到完成
    • 获取并处理结果 artefacts（模型、日志、曲线等）

• 说明与注意

  • 服务器实现覆盖了 MCP 的核心流程：工具注册、作业提交、状态查询、结果获取与 artefact 管理，且提供对 SSE 的传输支撑。
  • 服务器端通过示例文件 examples/calculation/server.py 提供了一个可直接运行的启动入口，便于快速搭建与测试。