使用说明（Markdown格式）

1. 项目简介

• URSA MCP 服务端是在本地或服务器端运行的后端服务，按 MCP 协议向客户端提供上下文信息与功能。它实现对资源、工具、以及提示模板的注册、管理和渲染，并通过 JSON-RPC 与客户端通信，支持会话管理、能力声明，以及多种传输方式。

2. 主要功能点

• MCP 核心能力：实现资源(Resource)、工具(Tools)注册与执行，以及 Prompt 模板的渲染与提供。
• JSON-RPC 通信：服务器接收客户端请求并返回符合 MCP 规范的 JSON-RPC 响应，支持对运行请求的触发与结果返回。
• 会话管理与能力声明：服务器端维护会话状态，声明可用能力与当前会话信息。
• 传输协议扩展：设计上支持多种传输协议，便于与不同 LLM 客户端集成（如本地 STDIO、SSE、WebSocket 等实现扩展）。
• 安全与扩展性：提供工具执行、资源访问及 sandbox 相关的集成点，便于在受控环境中运行外部功能。

3. 安装步骤

• 安装 MCP 支持的扩展包（示例，与仓库 README/实现一致）：
  • pip install 'ursa-ai[mcp]'
  • 或通过 uv 安装工具： uv tool install 'ursa-ai[mcp]'
• 启动 MCP 服务器（本地测试示例）：
  • ursa serve
  • 这会在本地端口 8000 启动，默认绑定到 127.0.0.1。
• 测试 MCP 服务器端接口：
  • 客户端向 http://localhost:8000/run 发送 JSON-RPC 请求，示例请求形式见下方“服务器配置”段。

4. 服务器配置（MCP 客户端所需的启动配置示例） 为了让 MCP 客户端能够与服务器建立连接，提供一个服务器启动配置示例（JSON 格式，客户机端用于描述如何连接服务器；注释性说明请忽略，不在实际 JSON 内使用）： { "server_name": "URSA-MCP-Server", "command": "ursa", "args": ["serve", "--host", "127.0.0.1", "--port", "8000"] } 说明:

• server_name: 服务器在客户端侧的标识名称（用于日志与 UI 表示）。
• command: 启动 MCP 服务器的命令（这里使用 URSA 的入口命令）。
• args: 启动参数，包含主机与端口等连接信息。MCP 客户端将使用此信息建立与服务器的 JSON-RPC 通道。

5. 基本使用方法

• 启动服务器后，客户端可以通过发送 MCP 兼容的请求来调用已注册的代理/工具，如执行、规划、网页检索等。
• 常见请求示例（客户端侧，JSON-RPC 风格，非代码块文本展示）：
  • 请求目的：调用执行代理以“执行某个计划”。
  • 请求字段示例（非代码块文本）： { "agent": "execute", "query": "执行你所规划的任务的具体实现步骤" }
• 服务器端将返回符合 MCP 规范的 JSON-RPC 响应，包含执行结果、生成的代码、日志等信息，客户端可据此进行后续处理。
• 服务器自带文档端点：
  • 运行时文档地址为 http://localhost:8000/docs，提供 API 文档与可探索的接口。
• 维护与扩展：
  • 服务端通过插件/工具节点注册可用的工具与资源，便于在不同场景下扩展能力。
  • 如需自定义新工具或资源，按照仓库实现的扩展模式接入并在 MCP 配置中注册。

6. 备注

• 本实现具备实际的 MCP 服务端能力与可运行性，非仅演示或测试用示例。
• 如需进一步定制化，例如增加新的传输协议、或引入更复杂的访问控制，请参考源代码中的工具/模块扩展点。