英语| 简体中文
代理技能管理器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=trueMCP服务器的环境变量。
\[！警告\] 环境意识：通常，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"
},
...
}它是如何工作的：
- 动态分辨率：每当AI工具请求提取技能时（使用
pull_skill_to_project或pull_skill_to_global工具），它通过其ide_nameMCP服务器在中查找该名称ide-config.json. - 项目位置：路径位于
project相对于您当前的工作空间根进行解析（例如。，.cursor/skills成为/path/to/your/project/.cursor/skills). - 全球位置：路径位于
global首先~/自动解析到您的操作系统的绝对用户主目录（例如。，~/.aider/skills无缝变成C:\Users\Username\.aider\skills在Windows或/Users/User/.aider/skills在Mac上）。 - 定制工具：只需在JSON文件中创建一个新键，您就可以添加任何全新的CLI工具或AI编辑器。MCP服务器将立即支持将技能引入其中。
- 工具变体：不同的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 文件和其他相关技术资产）。