使用说明（Markdown 格式）

• 项目简介 WeKnora 的 MCP 服务端实现旨在为大型语言模型（LLM）客户端提供一致的上下文信息与功能能力。它托管并管理资源（Resources）、注册并执行工具（Tools），并支持定义/渲染 Prompt 模板（Prompts）。通过 JSON-RPC 与客户端通信，处理读取资源、调用工具、获取 Prompt 等请求，并返回结构化的 JSON-RPC 响应。服务端负责会话管理、能力声明，以及对传输协议（如 Stdio、SSE、WebSocket）的支持，确保安全、可扩展的后端上下文服务。

• 主要功能点

  • MCP 资源管理：集中托管与访问资源，提供数据访问能力。
  • MCP 工具注册与执行：允许 LLM 客户端注册工具，并通过服务器执行外部功能。
  • Prompt 模板定义与渲染：为不同场景提供可配置的 Prompt 渲染与上下文管理。
  • JSON-RPC 通信：标准化的请求/响应路径，便于 LLM 客户端对接。
  • 会话与能力声明：服务器端维护会话状态，声明可用能力与工具集合。
  • 多传输协议支持：支持 Stdio、SSE、WebSocket 等传输方式，提升集成灵活性。
  • 安全与扩展性：集成鉴权、租户隔离和可扩展的工具/资源/提示生态。

• 安装步骤（简要概览）

  1. 准备运行环境（Python/Node/Go 等依赖，依照仓库提供的 MCP 模块说明安装）。
  2. 获取 MCP 服务端代码（仓库内含的 mcp-server 目录，包含启动脚本与配置指南）。
  3. 按 MCP_CONFIG.md 的配置要求进行配置，确保服务端能正确暴露所需端点与能力。
  4. 安装并启动 MCP 服务端：执行启动脚本或命令，确保服务正常对外提供。
  5. 如有需要，配置前端/客户端的 MCP 连接信息（通过客户端配置指向服务器启动命令与参数）。

• 服务器配置（MCP 客户端对 MCP 服务器的连接配置说明，JSON 格式描述，简介字段如下）

  • server_name: 服务器实例名称，便于区分多实例。
  • command: 启动 MCP 服务器的执行命令。
  • args: 启动命令的参数列表，指向服务器入口脚本或可执行文件。
  • env: 可选的环境变量设置，用于诸如 API Key、基础地址等。 注意：客户端连接 MCP 服务器需要提供上述字段以建立连接，具体字段及取值请结合仓库 mcp-server 的 MCP_CONFIG.md 配置示例与注释。

  伪示例（以结构化描述方式呈现，不包含可执行代码）： { "mcpServers": { "weknora": { "name": "WeKnora MCP Server", "command": "python", "args": [ "mcp-server/run_server.py" ], "env": { "WEKNORA_API_KEY": "Enter your WeKnora API key", "WEKNORA_BASE_URL": "https://your-weknora-address/api/v1" } } } }

• 基本使用方法

  • 部署后，MCP 客户端通过指定的 server name/启动命令与参数连接到 MCP 服务器。
  • 客户端可通过 JSON-RPC 请求服务器的资源、工具与 Prompt 等能力，获得统一的上下文信息用于 LLM 推理。
  • 服务器负责会话管理、能力声明以及对传输协议的适配，确保跨模型/跨平台的可操作性。

• 备注

  • 本仓库内的 MCP 相关实现通常包括客户端示例与服务器端实现的描述、MCP 配置指南及示例。请严格按照仓库中的 MCP_CONFIG.md、MCP_CONFIG 示例及 run_server.py 等文档进行对接和配置。