Sofia Intuition MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • Sofia Intuition MCP 服务器是一套实现 Model Context Protocol 的后端服务，负责托管和管理 Resources（数据资源）、Tools（工具注册与执行）以及 Prompts（提示模板），并通过 JSON-RPC 与 MCP 客户端通信，提供会话管理、能力声明，以及多传输协议支持，帮助 LLM 应用高效获取上下文信息与外部功能。

• 主要功能点

  • 资源与数据管理：集中托管可供 LLM 客户端读取的数据资源与数据访问能力。
  • 工具注册与执行：注册外部工具，并支持 LLM 通过 JSON-RPC 调用执行。
  • Prompt 模板定义与渲染：提供可定制化的 Prompt 模板以引导 LLM 的交互。
  • JSON-RPC 交互：服务器端接收并响应 MCP 客户端请求，支持请求-响应模式以及通知。
  • 会话与能力声明：管理会话、版本能力、并对外宣告服务器能力。
  • 多传输协议：支持 SSE、Stdio、WebSocket 等传输模式以服务不同客户端场景。

• 安装步骤

  • 克隆仓库并进入 MCP 服务器目录：
    • 安装依赖并安装必要的运行环境
    • 启动 MCP 服务器（端口默认 3001，读取 README 的运行指令）
  • 启动示例（参考仓库 Quick Start 指引）：
    • 进入 intuition-mcp-server 目录，执行安装与启动命令，启动后将监听 http/sse 端口，提供 MCP 服务入口。

• 服务器配置（MCP 客户端需要）

  • 由于 MCP 客户端需要通过配置文件了解服务器启动命令与参数，以下为准确的示例配置要点（注意以下为描述性信息，非代码块）：
    • serverName: Sofia Intuition MCP Server
    • command: 指向运行 MCP 服务器的命令，例如 pnpm
    • args: 运行 MCP 服务器的参数，例如 run start:http
    • 备注：
      • MCP 服务器在仓库内的 intuition-mcp-server 提供了启动脚本 start:http，端口通常为 3001，MCP 客户端将通过 SSE 或 HTTP 与之通信。
      • 客户端配置不需要在服务器端脚本中体现，只需要提供命令和参数来启动服务器即可，MCP 客户端会以服务器地址（如 http://localhost:3001/sse）进行连接，随后使用 JSON-RPC 进行通信。

• 基本使用方法

  • 启动与连接
    • 在服务器环境中启动 MCP 服务（如执行提供的启动命令和参数）。
    • 通过 MCP 客户端（语言模型集成方或自定义客户端）连接服务器，使用 SSE 或 HTTP 传输协商建立连接。
  • 发起请求
    • 客户端通过 JSON-RPC 向服务器发送请求，获取资源、调用工具、获取 Prompt 等。
  • 处理返回
    • MCP 服务器返回标准的 JSON-RPC 响应或通知，供客户端进行后续处理与对话管理。

• 额外信息

  • 服务器端提供 health-check 端点，便于运维监控健康状态。
  • 服务器端实现遵循 MCP 的核心交互模式，确保与 LLM 客户端的兼容性。