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