UNCASE MCP 服务器

关键词

模型上下文协议工具暴露模板渲染图谱化上下文链接LLM与数据

使用说明内容（Markdown格式）

  • 项目简介

    • 这是一个以 UNCASE 框架为基础、实现 MCP 协议的服务器端组件。它通过 FastMCP 提供对 LLM 客户端的工具注册、资源访问与模板渲染等能力，允许客户端通过 MCP 格式请求读取资源、注册或执行工具、获取并渲染 Prompt 模板等。

  • 主要功能点

    • MCP 服务器实现：提供通过 FastMCP 的工具暴露接口，支持读取和执行资源、调用工具、获取并渲染提示模板等。
    • 工具暴露与执行：定义若干工具（如健康检查、域列表、模板渲染、工具列举等），便于 LLM 客户端调用。
    • 模板与域信息：提供获取领域域名、模板清单、模板渲染等能力，便于 LLM 客户端在对话中使用合适的 Prompt 模板。
    • 端口和传输：通过 ASGI 兼容方式暴露接口，理论上可通过拥护的传输（如流式 HTTP/WS 等）接入 MCP 客户端。
    • 与 UNCASE 生态的互操作：利用现有 Seeds/Knowledge/Tools/Template 等子系统，提供一致的上下文服务入口。

  • 安装步骤（简化版）

      1. 确保使用 Python 3.11 及以上环境。
      1. 将代码获取到本地环境（例如通过 git clone 到本地工作目录）。
      1. 安装所需依赖（根据项目的依赖管理方式执行，如 pip install -r requirements.txt 或 Poetry 安装依赖）。
      1. 在本地配置环境变量（如数据库、API KEY 等，按项目实际需要）并准备好运行环境。
      1. 启动 MCP 服务器（后文给出示例启动命令）。确保网络可访问端口开放。

  • 服务器配置（JSON 形式，供 MCP 客户端使用） 请注意：以下配置字段用于 MCP 客户端与服务器的对接示例，描述服务器的启动信息与对外暴露的服务入口。服务器端实现细节在代码中，客户端只需要按照此配置启动并连接。

    { "server_name": "UNCASE-MCP-Server", "command": ["uvicorn", "uncase.mcp.server:create_mcp_app", "--host", "0.0.0.0", "--port", "8000"], "args": [ "--host=0.0.0.0", "--port=8000" ], "description": "UNCASE MCP 服务器，暴露 Seeds/Tools/Templates 等 MCP 工具，供 LLM 客户端通过 MCP 协议调用。", "transport": "streamable-http", "notes": "默认启动端口 8000，如需自定义请修改命令中的端口。" }

  • 基本使用方法

    • 启动后，MCP 客户端即可通过定义的工具进行请求，例如查询健康状态、获取域列表、渲染模板、评估对话等。
    • 客户端可以通过 MCP 的请求格式向服务器发送读取资源、执行工具、获取 Prompts 的请求，服务器返回相应的 JSON-RPC 风格响应或通知。

  • 其他说明

    • 服务器端实现使用 FastMCP 提供工具装饰器来暴露 MCP 工具接口，工具函数包括健康检查、域列表、模板渲染、对话评估、工具清单等。
    • 服务器还提供 create_mcp_app 入口，可被作为 ASGI 应用挂载到现有 FastAPI/Starlette 应用中，或独立运行。

服务器信息

访问项目