Agent Skills Manager MCP

英语| 简体中文

代理技能管理器MCP（MCP服务器）

充当AI代理“技能库管理器”的模型上下文协议（MCP）服务器。 它提供了在各种AI增强的IDE和代理框架之间管理和共享AI规则/技能的工具。

特性

• 查询：从人工智能技能中央图书馆阅读。支持 标准代理技能格式 （目录包含 SKILL.md 使用标准的YAML元数据）。
• Push（项目）：提取IDE特定的规则文件（如 .cursor/rules/something.mdc 使用frontmatter）并精确地采用标准将其保存到中央技能库 /SKILL.md 格式。
• 推送（全局）：从全局工具字典中向后推一项技能（例如。 ~/.trae/skills/xyz)进入中央图书馆。
• 拉动（项目）：从中央库中提取指定的技能，并将其格式化为当前项目中的特定环境（例如，本机注入YAML frontmatter）。
• 拉动（全局）：提取指定的技能，并将其原生格式化到用户的全局工具规则目录中。
• 删除（选择加入）：从中央库中永久删除技能。默认情况下，此破坏性工具为 残疾的 以防止意外数据丢失。必须通过传递 AGENT_SKILLS_ENABLE_DELETE=true MCP服务器的环境变量。

\[！警告\] 环境意识：通常，AI助手不知道他们正在运行的确切编辑器/CLI。当要求AI拉或推技能时，如果遇到困难，强烈建议在提示中明确说明： *“我目前正在使用Cursor/Trae/Windsurf/等，请将此技能拉到我的全局/项目词典中”* 以确保选择正确的路径。

可配置路径(ide-config.json)

是的，此配置文件功能齐全，可以主动控制技能的保存位置！

服务器根据AI工具动态管理目标路径。首次运行时，它会生成 data/ide-config.json 在技能库旁边。

\[！提示\] 关于路径精度：由于版本更新和各种工具之间的环境差异，默认生成的路径可能不是100%准确。建议您手动调整中的路径 ide-config.json 以匹配您的实际工具链布局。

示例结构：

{
  "cursor": {
    "project": ".cursor/skills",
    "global": "~/.cursor/skills"
  },
  "my-custom-cli": {
    "project": ".mycli/agents",
    "global": "~/.config/mycli/agents"
  },
...
}

它是如何工作的：

1. 动态分辨率：每当AI工具请求提取技能时（使用 pull_skill_to_project 或 pull_skill_to_global 工具），它通过其 ide_nameMCP服务器在中查找该名称 ide-config.json.
2. 项目位置：路径位于 project 相对于您当前的工作空间根进行解析（例如。， .cursor/skills 成为 /path/to/your/project/.cursor/skills).
3. 全球位置：路径位于 global 首先 ~/ 自动解析到您的操作系统的绝对用户主目录（例如。， ~/.aider/skills 无缝变成 C:\Users\Username\.aider\skills 在Windows或 /Users/User/.aider/skills 在Mac上）。
4. 定制工具：只需在JSON文件中创建一个新键，您就可以添加任何全新的CLI工具或AI编辑器。MCP服务器将立即支持将技能引入其中。
5. 工具变体：不同的AI助手或编辑器可能有不同的路径要求。您可以通过编辑轻松调整目标位置 ide-config.json 以匹配您的本地设置。即使助手使用通用标识符，服务器也会无缝地将文件路由到正确的文件夹。

构建并运行

先决条件

• Node.js>=20
• npm

安装

git clone https://github.com/MTQwQ/Agent-Skills-Manager-MCP.git
cd Agent-Skills-Manager-MCP
npm install

发展

npm run dev

构建

npm run build

然后，您可以使用以下命令启动构建的服务器：

npm start

注意：根据您的环境，您可能需要使用以下命令将MCP客户端指向脚本的确切路径 node /absolute/path/to/agent-skills-manager-mcp/build/index.js.

配置示例

在编辑器的MCP设置中，添加新的stdio连接：

{
  "mcpServers": {
    "agent-skills-manager-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/agent-skills-manager-mcp/build/index.js"
      ]
    }
  }
}

启用删除工具（可选）

如果你必须使用 delete_skill_from_library 工具，您必须将opt-in环境标志注入IDE连接设置中，如下所示：

{
  "mcpServers": {
    "agent-skills-manager-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/agent-skills-manager-mcp/build/index.js"
      ],
      "env": {
        "AGENT_SKILLS_ENABLE_DELETE": "true"
      }
    }
  }
}

其他工具（示例）

对于Windsurf，您可以在您的 mcp.json 或等效配置：

{
  "mcpServers": {
    "agent-skills-manager-mcp": {
      "command": "node",
      "args": [
        "/absolute/path/to/agent-skills-manager-mcp/build/index.js"
      ]
    }
  }
}

*（记得更换 /absolute/path/to/agent-skills-manager-mcp 使用文件系统上的实际位置。)*

数据目录

默认情况下，服务器管理 data/skills/ 项目根目录旁边的目录。技能存储在那里 标准代理技能格式 （每个技能都是一个目录，其中包含 SKILL.md 文件和其他相关技术资产）。