Agent Skills MCP 服务器

使用说明

• 项目简介

  • 本仓库实现了一个基于 MCP（Model Context Protocol）的后端服务器，专门为 AI 代理生态提供可暴露的技能目录、工具以及提示模板等上下文信息。服务器通过 JSON-RPC 标准与客户端通信，支持资源读取、工具调用以及提示渲染等核心能力，方便 LLM 客户端在对话中动态获取所需上下文与能力。

• 主要功能点

  • 资源管理（Resources）
    • 托管并暴露技能目录中的资源信息（如 SKILL 描述、文件等），允许客户端按需加载资源内容。
  • 工具注册与执行（Tools）
    • 提供若干 MCP 工具，例如技能搜索、技能列表、读取技能主文件、获取参考文件等，LLM 客户端可按需调用外部功能以获取数据或执行任务。
  • 提示模板定义与渲染（Prompts）
    • 定义并渲染用于与技能系统交互的 Prompt 模板，支持可定制的交互模式，帮助 LLM 客户端在对话中更高效地使用技能。
  • 服务器行为与协议
    • 使用 MCP 框架（fastmcp）实现 JSON-RPC 风格的请求/响应，处理对 Resources、Tools、Prompts 的请求。当前实现以 stdio 传输为默认通道，便于在本地进程间直接通信。
  • 会话与能力声明
    • 服务器在启动阶段加载技能索引（基于 CDN 的注册表），并对外暴露能力（支持的资源、工具、Prompts），以便客户端在后续对话中查询与调用。
  • 缓存与同步
    • 通过 TTL 缓存注册表数据，后台定时轮询更新索引，确保客户端访问到的技能信息是最新的一致视图。

• 安装与运行

  • 使用方式：npx @tech-leads-club/agent-skills-mcp
  • 启动后，服务器将以 MCP 规范对外提供服务，客户端可通过 MCP 配置与服务器建立连接并发起请求。

• MCP 客户端配置示例

  • 服务器名称：agent-skills
  • 启动命令与参数（示例，客户端配置所需信息）： { "server": "agent-skills", "command": "npx", "args": ["-y", "@tech-leads-club/agent-skills-mcp"] } 注释：该配置仅用于 MCP 客户端在本地或远端启动并连接到服务器。客户端不需要本仓库的实现细节信息，仅需上述提供的启动指令即可建立连接。

• 基本使用方法

  • 启动：运行 MCP 服务器（如上所述命令）后，服务端将启动并暴露 MCP 能力。
  • 客户端对接：MCP 客户端通过 JSON-RPC 向服务器发起请求，访问资源、调用工具、获取提示模板等能力，并获取标准化的 JSON 响应。
  • 扩展性：服务端基于模块化设计，易于新增更多资源、工具与 Prompt，满足不同 LLM 客户端的上下文需求。