Awesome Agent Skills MCP 服务器

使用说明内容(Markdown格式)

项目简介

  • 该项目实现了一个 MCP 服务器,用于向 LLM 客户端以标准化方式提供技能资源、可调用的外部工具,以及可渲染的 Prompt 模板。服务器通过 JSON-RPC 与客户端进行通信,支持技能注册、执行、查询与刷新等核心能力。

主要功能点

  • 资源与技能管理
    • 通过 SkillRegistry 管理技能资源,支持从远程仓库和本地源加载、覆盖与覆盖优先级控制、以及缓存化存储。
  • 工具注册与执行
    • 内置 MCP 工具集(列出技能、获取技能信息、调用技能、刷新技能等),支持参数校验、执行时间统计与错误返回。
  • 提供和渲染 Prompt/文档
    • 能返回技能文档、示例内容等,便于在对话中向 LLM 客户端提供上下文。
  • MCP 协议实现
    • 通过 MCP Server 实现,提供 ListTools、CallTool 等请求处理,返回按照 MCP 规范格式的响应。
  • 持续同步与缓存
    • 支持通过 GitSync 进行远程技能仓库的拉取与同步,支持自动同步计划,以及本地/远程技能的整合。
  • 运行环境与传输
    • 现阶段实现以标准输入输出(stdio)传输为 MCP 通信通道,便于与多种客户端集成测试。

安装步骤

  • 安装依赖与构建
    • 安装项目依赖并编译 TypeScript 代码以生成可执行的 dist 目录。
  • 启动服务器
    • 使用 Node 直接运行 dist/index.js 启动 MCP 服务器。
  • 运行前提
    • 确保网络可访问远程技能仓库、必要的本地技能路径配置,以及对日志级别与同步间隔的环境变量配置。

服务器配置(MCP 客户端配置示例说明)

  • MCP 客户端在连接 MCP 服务器时需要提供启动命令与参数等信息,JSON 配置示例如下(供参考,请按实际环境使用): { "serverName": "awesome-agent-skills-mcp", "command": "node", "args": ["dist/index.js"], "description": "启动 Awesome Agent Skills MCP 服务器的命令及参数,MCP 客户端将通过标准输入/输出进行 JSON-RPC 通信。" } 说明
  • serverName 为服务器标识,用于客户端在多服务器场景中辨识。
  • command 为启动服务器的命令,args 为传给命令的参数数组(如 Node 执行 dist/index.js)。
  • 该配置仅用于 MCP 客户端在连接阶段的描述信息,实际通信仍通过 MCP 服务器返回的 JSON-RPC 规范进行。

基本使用方法

  • 启动与初始化
    • 启动服务器进程后,客户端发送 initialize 请求,携带协议版本、能力、客户端信息等。
  • 获取工具列表与调用技能
    • 使用 tools/list 获取可用工具(如 list_skills、get_skill、invoke_skill、refresh_skills 等)。
    • 使用 tools/call 传入 name 和参数,执行相应操作并接收结果或错误信息。
  • 缓存与刷新
    • 通过 refresh_skills 工具可触发服务器端的技能刷新、重新加载技能并更新缓存。
  • 常见流程
    • 启动服务器 → initialize → list tools → 调用具体工具(如 list_skills、get_skill、invoke_skill) → 根据需要执行刷新以保持技能最新。

关键词 AI技能管理, 工具执行框架, 资源管理, Git 同步, 自动化工作流

分类ID 6

服务器信息