InfoMosaic MCP 服务器框架

使用说明(简要概览)

  • 项目简介

    • InfoMosaic 是一个面向信息集成与推理场景的 MCP 服务器框架集合,支持将资源、工具和提示模板统一托管在服务器端,LLM 客户端可通过标准化的接口读取资源、调用工具、获取并渲染提示模板,形成可扩展的上下文服务体系。
  • 主要功能点

    • 资源 (Resources) 的托管与数据访问能力
    • 工具 (Tools) 的注册、执行与输出处理
    • 提示模板 (Prompts) 的定义与渲染,支持可定制的交互模式
    • 与客户端通过 JSON-RPC/类似接口的请求响应风格进行通信
    • 多传输协议支持:如 STDIO、SSE、WebSocket 等,用于不同环境的集成
    • 会话与能力声明、以及对接外部服务的工具后端(包括后端工具、API 代理、以及安全沙箱执行等)
  • 安装步骤

    • 克隆仓库并进入项目目录
    • 按需要安装依赖,例如 Python 包的安装方式(通常是通过 pip 安装可用的 package 或在本地开发环境中安装)
    • 根据需求启动对应的 MCP 服务后端(如 base Tool Server、Google Maps、YouTube、Serper 等示例后端)
    • 启动后端后,MCP 客户端即可连接,读取工具/资源列表并执行工具调用
  • 服务器配置(MCP 客户端所需信息,注释为示例用法,非代码)

    • 服务器名称: InfoMosaic_BaseToolServer
    • 可执行命令与参数(JSON 配置示例说明,非代码)
      • server_name: "InfoMosaic_BaseToolServer"
      • command: "python"
      • args: ["tool_server.py"] // 基础工具服务器脚本路径(本仓库中的 tool_server.py)
      • transport: "stdio" // 传输方式,标准输入输出模式
      • 其他环境变量(如需要)请在实际部署时通过环境变量配置
    • 说明
      • MCP 客户端通过上述信息启动本地脚本作为一个 MCP 服务端实例,随后会按 MCP 协议对外暴露工具与资源的查询、调用等能力。具体的 server 启动参数需结合实际运行环境与目标后端脚本的实现来设置。
  • 基本使用方法

    • 启动并连接
      • 使用配置中的命令在本地启动服务器脚本(如 tool_server.py),确保环境就绪后,MCP 客户端可以通过 STDIO 或其他传输方式连接到服务器。
    • 读取能力
      • 客户端连接成功后即可获取服务器暴露的 Tools、Resources、Prompts 等元信息,进而调用相应工具。
    • 调用工具
      • 通过提供工具名称和参数,将请求发送至 MCP 服务器,服务器执行并返回结果。
    • 会话与安全
      • MCP 服务器实现通常会维护会话、能力声明,并支持对外暴露的工具/资源范围,确保使用时遵循相应的认证与授权策略。
  • 备注

    • 本项目包含多套服务器实现,覆盖不同后端服务(如基于 Google Maps、Serper、YouTube 等的工具),以及一个通用的工具服务器框架,适合在多场景下构建信息检索与信息整合工作流的上下文服务。
    • 具体的实现细节(如 JSON-RPC 调用细节、资源/工具的具体描述、Prompts 的渲染规则等)以各子模块实现为准,请在部署时参考各模块的文档与示例。
  • 参考要点

    • MCP 核心能力:资源、工具、提示模板的托管与执行
    • JSON 形式的请求-响应交互(及其扩展形态)
    • 支持多传输协议的后端实现

服务器信息