使用说明内容（Markdown格式）

简介

本仓库实现了一个基于 MCP（Model Context Protocol）的服务器端组件，用于 Ark UI 的 AI 助手生态。它通过 MCP 协议处理上下文资源、可注册执行的工具以及提示模板的管理与渲染，能够与支持 MCP 的大语言模型客户端进行标准化的 JSON-RPC 通信，并且提供多种传输协议的接入能力。

主要功能点

• MCP 核心服务
  • 处理 MCP 请求与响应，支持会话管理与能力声明
  • 提供资源（Resources）、工具（Tools）和提示模板（Prompts）的托管与管理
  • 支持工具注册与执行，允许 LLM 客户端调用外部功能
• 传输协议
  • 标准输入输出（stdio）传输：直接通过命令行运行的 MCP 服务入口
  • HTTP/SSE 传输：通过 Express 服务暴露 MCP 请求入口，适用于 Web 客户端
  • 兼容多种 MCP 客户端的连接方式，便于在不同环境下搭建
• 服务暴露与工具初始化
  • 服务启动后自动加载并注册工具集（如组件属性、示例、样式指南等）
  • 服务器名称、版本以及能力级别在服务器端明确定义
• 安全与会话管理
  • 通过传输层和会话机制管理客户端会话，确保请求的归属性和状态跟踪

安装与运行

• 获取代码：从本仓库获取集成的 MCP 服务器实现代码（integrations/mcp 目录下）。
• 构建与运行（可选实现方式之一）：
  • 使用 stdio 传输的入口：将代码编译后在命令行执行相应入口（stdio.ts），以便通过标准输入/输出进行 MCP RPC 交互。
  • 使用 HTTP/SSE 传输的入口：启动 Express 服务，暴露 /mcp 等接口以便通过网络进行 MCP 通信。
• 运行后，服务器会输出运行信息，指示 MCP 服务已经就绪可供客户端连接。

服务器配置（请根据 MCP 客户端需求提供的配置示例）

以下配置用于 MCP 客户端连接 Ark UI 的 MCP 服务器。服务端在本仓库中定义了服务器名称和启动方式，客户端需要知道启动命令及参数来建立连接。请将以下信息用于客户端连接配置（JSON 格式，描述性注释紧随其后）：

{ "serverName": "ark-ui", "command": "node", "args": [ "integrations/mcp/src/stdio.ts" ], "description": "MCP 服务器入口（stdio 传输） - Ark UI 的 MCP 服务器，提供资源、工具和提示模板等能力。若使用 HTTP/SSE，请改用 http.ts 的入口并相应调整传输设置。" }

注：

• serverName 对应服务器在代码中定义的名称（ark-ui）。
• command 与 args 指向启动入口。仓库同时提供 stdio 与 HTTP 两种入口，客户端可按实际部署选择对应入口启动。
• 若将来使用 HTTP/SSE 传输，请将入口改为 "integrations/mcp/src/http.ts" 并确保网络可达。

基本使用方法

• 启动后连接方式：MCP 客户端通过 JSON-RPC 与服务器交互，包含读取资源、执行工具、获取提示模板等能力。
• 客户端需要提供会话上下文并遵循 MCP 协议的初始化流程，服务器会在初始化阶段声明自身能力与会话状态。
• 常见操作包括：初始化会话、注册工具、执行工具调用、请求 Prompts、查询 Resources 等等。
• 与 Ark UI 的集成场景紧密相关，适合将 LLM 放在后端代理，向前端或代理模型提供结构化的上下文服务。

参考与注意

• 代码库中的 MCP 实现包含 stdio 与 HTTP(SSE) 两种传输实现，以及工具初始化逻辑，符合 MCP 服务器的核心职责要求。
• 本回答依据仓库现有实现进行判断，若未来对接需要特定网络环境或容器化部署，请结合实际运行环境调整启动命令与参数。