使用说明

项目简介
- 这是一个基于 MCP 的服务器实现，旨在为大语言模型（LLM）客户端提供统一的静态站点生成框架上下文与功能。它把多个 SSG 的工具与能力整合在一起，通过标准化的 JSON-RPC 形式对外提供，并支持本地 STDIO 模式以及远端 HTTP 流式传输模式，便于云端部署与无头环境运行。
主要功能点
- 元工具（Meta Tools）: ssg_list、ssg_detect、ssg_help、ssg_version，用于查询可用的 SSG、检测系统中可用的适配器、获取帮助信息以及版本信息。
- 适配器工具集成: 将 28-29 种 SSG 的工具逐一注册为 MCP Tool，统一入口执行，自动连接或提示未安装的适配器。
- 两种传输模式
  - STDIO 模式：本地 MCP 客户端通过标准输入输出与服务器交互。
  - HTTP 模式：流式 HTTP 传输，支持 MCP Streamable HTTP 协议，适合云端部署与前端/后端分离场景。
- 会话与安全特性（在传输实现中体现）:
  - 会话管理、速率限制、超时控制、简单的断路器等机制，提升鲁棒性。
- 适配器工具执行流程: 若适配器未连接，将自动尝试连接；连接失败时给出清晰错误信息；成功后执行具体工具并返回可读文本或 JSON。
安装步骤
- 需要具备运行 Den o（或 Deno 环境）以及对 MCP 服务器的运行权限。
- 下载或克隆代码后，在本地执行环境中按如下方式启动：
  - 本地开发（STDIO 模式）: deno task start
  - 部署/云端（HTTP 流式模式）: deno task serve
- 注意：具体执行命令以仓库提供的入口点为准，默认入口支持双模式入口点（STDIO 与 HTTP），运行时会自行选择模式。
服务器配置（MCP 客户端所需信息）说明：MCP 客户端通常需要一个简要的配置信息来连接服务器，包含服务器名称、启动命令及参数等。以下示例仅供参考，实际客户端可能从环境变量或界面读取配置。
- 本地 STDIO 模式示例 { "serverName": "polyglot-ssg-mcp", "command": "deno", "args": ["task", "start"], "transport": "stdio", "notes": "本地开发使用 STDIO 交互，服务器将通过标准输入输出与 MCP 客户端通信。" }
- HTTP 模式示例（部署/云端） { "serverName": "polyglot-ssg-mcp", "command": "deno", "args": ["task", "serve"], "transport": "http", "endpoint": "http://<host>:<port>/mcp", "notes": "HTTP 传输，端点为 /mcp，适配器通过流式响应与请求进行 MCP JSON-RPC 通信。"
基本使用方法
- 启动方式选择：在本地使用 STDIO，或在云端/容器中使用 HTTP 传输模式。
- 与 MCP 客户端交互：客户端通过发送 JSON-RPC 请求（initialize、tools/list、tools/call 等）来查询能力、调用具体 SSG 工具。
- 适配器状态与故障处理：若某个 SSG 未安装或未连接，服务器会提示并在需要时尝试连接；错误信息会帮助诊断缺少依赖或环境配置问题。

关键词

信息