使用说明

• 项目简介

  • 本仓库实现了一个基于 MCP（Model Context Protocol）的服务器端组件，用于向大型语言模型（LLM）客户端提供上下文资源、可执行工具、以及可渲染的提示模板。服务器通过 JSON-RPC 与客户端通信，支持标准的资源读取、工具调用、以及提示渲染等能力注册和执行，同时具备会话管理、能力声明和传输协议的扩展性。

• 主要功能点

  • MCP 服务器核心：提供注册的 Tool、Resource、Prompt 等能力，处理来自客户端的 JSON-RPC 请求并返回结构化响应。
  • 资源与工具Mgmt：托管与管理资源（Resources），注册并执行 Tools，让 LLM 能调用外部功能。
  • Prompt 模板渲染：支持将 Prompts 与模板渲染逻辑集成到 MCP 服务中，便于统一上下文输出。
  • 会话与能力声明：服务器端负责会话状态、能力声明以及与客户端协商的能力清单。
  • 多传输协议支持：内置 stdio 传输用于与 VS Code 等集成环境通信，同时具备扩展到 SSE、WebSocket 等传输的设计。
  • 与现有工作流整合：包含针对 Copilot Setup Steps 场景的工具集和用例，展示如何通过 MCP 服务器提供外部能力。

• 安装步骤

  • 使用前提：本仓库采用 TypeScript/Node.js 生态，需具备 Node.js 环境。
  • 构建产物与启动
    • 构建项目以生成 dist 目录中的 MCP 服务可执行文件。
    • 启动 MCP 服务器，生成的 dist/mcp-server.js 将通过 stdio 传输提供 MCP 服务。典型启动方式为执行 dist/mcp-server.js（例如 node dist/mcp-server.js）。
  • 常用的开发与运行流程
    • 安装依赖并构建：安装依赖后执行构建，得到可执行的 dist 产物。
    • 启动服务：node dist/mcp-server.js，服务将以 stdio 传输与客户端通信（如 VS Code 的 mcp.json 配置）。

• 服务器配置（JSON，用于 MCP 客户端的连接配置说明，客户端在连接时可参考下列字段来建立连接；不需要在代码中嵌入，仅供配置参考） { "serverName": "lousy-agents-mcp", "command": "node dist/mcp-server.js", "args": [ "--transport=stdio" ], "description": "MCP 服务器实例名称与启动参数，客户端通过该配置连接到 MCP 服务器，获取资源、工具与提示模板等能力。" }

• 基本使用方法

  • 客户端需要的前提：在与 MCP 服务器对接前，客户端需要知道服务器的名称、启动命令与参数，以便通过 MCP 协议发起 JSON-RPC 请求（如读取资源、调用工具、获取 Prompt 等）。
  • 客户端协议要点：通过 JSON-RPC 进行请求/响应，服务器返回标准的 JSON 结构，包含成功标志、数据，以及必要的错误信息。
  • 使用场景示例：在开发阶段，LLM 可以通过 MCP 服务器获取环境资源、注册工具、执行工具、以及渲染 Prompts，以实现对外部能力的访问与上下文注入。