FOUNDATION MCP 服务器实现

关键词

本地AI助手RDF三元组JSON-RPC工具执行本体管理

使用说明内容（Markdown格式）

  • 项目简介

    • FOUNDATION MCP 服务器是一部分嵌入在 FOUNDATION 桌面应用中的后端服务，按照 MCP（Model Context Protocol）规范，通过 JSON-RPC 2.0 与 LLM 客户端通信，提供资源管理、工具执行与提示模板渲染等能力，帮助 LLM 客户端获取上下文、访问数据和调用外部功能。

  • 主要功能点

    • 资源与数据访问：提供对本地 RDF/本体数据及资源的统一访问方式，作为 LLM 的外部上下文源。
    • 工具注册与执行：暴露可注册的“工具”，允许 LLM 客户端调用外部功能并返回结构化结果。
    • Prompt 模板管理与渲染：支持提示模板的定义、渲染与渲染结果的返回，用于驱动 LLM 的对话形式与任务执行。
    • JSON-RPC 通信：通过标准的 JSON-RPC 2.0 协议处理请求与应答，包含初始化、工具列表、工具调用等方法。
    • 本地运行与集成：作为 FOUNDATON 应用的一部分启动，在本地端口监听，并与应用内部的会话与能力管理协同工作。

  • 安装步骤

    • 本仓库将 MCP 服务器作为应用的一部分启动，在运行 FOUNDATION 桌面应用时自动启动。

  • 服务器配置（客户端需要的配置信息，JSON 格式，注释仅供理解，客户端不需要）

    • serverName: "FOUNDATION MCP Server"
    • command: "Launch FOUNDATION desktop application (TAURI app)"
    • args: ["（默认启动，包含内置 MCP 服务）"] 注释说明：MCP 客户端需要知道服务器标识及如何启动服务器的指引信息，以便在需要时能够启动或描述连接信息。实际连接仍通过本地监听端口实现，客户端通过 MCP 提供的 JSON-RPC URL（如 http://localhost:47177/mcp）进行请求。

  • 基本使用方法

    • 启动阶段：直接启动 FOUNDATION 桌面应用，MCP 服务在应用启动时自动启动并监听本地端口 47177 下的 /mcp 路径。
    • 连接与初始化：客户端通过发送 MCP JSON-RPC 2.0 请求，先执行 initialize 获取能力声明与服务器信息（协议版本、能力等）。
    • 调用工具与查询资源：通过 tools/list 获取可用工具列表，通过 tools/call 调用具体工具并获取结果。
    • 会话与上下文：服务器负责会话管理与能力声明，并维护客户端上下文，便于 LLM 持续交互。
    • 安全与扩展：服务器后端与应用内的数据模型耦合，未来可扩展多传输协议（如 SSE、WebSocket 等）与安全策略。

  • 重要提示

    • MCP 客户端在使用时应按照服务器提供的能力进行请求与处理响应，服务器端实现为 FOUNDATION 应用内置服务，实际运行依赖应用启动。

服务器信息

访问项目