sim-xia/skill-cortex-server

一个第三方 MCP 服务器：让所有 IDE 获得 Claude Code Skills 的能力。
A third-party MCP server: Enable all IDEs to access Claude Code Skills capabilities.
Features / 特性
- **Skill Discovery & Indexing / 技能发现与索引**: Automatically scan and index SKILL.md files from multiple sources / 自动扫描和索引来自多个来源的 SKILL.md 文件
- **Flexible Configuration / 灵活配置**: Support for custom skill roots and cache paths / 支持自定义技能根目录和缓存路径
- **Tag Management / 标签管理**: Built-in tag validation and management system / 内置标签验证和管理系统
- **Skill Tree Navigation / 技能树导航**: Hierarchical browsing of skills by category / 按类别分层浏览技能
- **Search Functionality / 搜索功能**: Full-text search across all indexed skills / 对所有索引技能进行全文搜索
- **Skill Details / 技能详情**: Detailed information retrieval for each skill / 每个技能的详细信息检索
- **Enhanced Import Tools / 增强导入工具**: Advanced import script with configuration files, progress tracking, and robust error handling / 具有配置文件、进度跟踪和健壮错误处理的高级导入脚本
- **No Bundled Skills in Repo / 仓库不内置 Skills**: This repository does not ship skills by default; put your skills under ~/.claude/skills or ./.skills / 本仓库默认不内置 skills，请将 skills 放到 ~/.claude/skills 或 ./.skills
- **Context Compression / 上下文压缩**: Token-friendly skill retrieval with section-based extraction (summary, instructions, examples, full) / 支持按 section 提取技能内容，节省 token 消耗
Prerequisites / 先决条件
- Python 3.11 or higher / Python 3.11 或更高版本
- pip package manager / pip 包管理器
Key Technologies / 关键技术
- **MCP (Model Context Protocol)**: For server integration / 用于服务器集成
- **Python Standard Library**: File system operations and caching / 文件系统操作和缓存
Project Structure / 项目结构
Quick Start / 快速开始
Installation / 安装
Run the Server / 运行服务器
MCP Tools / MCP 工具
1. list_skill_tree / 列出技能树
Browse skills in a hierarchical tree structure / 以分层树结构浏览技能
**Parameters / 参数:**
- path (optional): Starting path in the skill tree / 技能树中的起始路径
**Example / 示例:**
**Response / 响应:**
Returns a hierarchical tree of skills with their metadata / 返回包含元数据的分层技能树
2. search_skills / 搜索技能
Search for skills by query text / 通过查询文本搜索技能
**Parameters / 参数:**
- query (optional): Search query string / 搜索查询字符串
- tags (optional): Array of tags to filter by / 用于筛选的标签数组
**Example / 示例:**
**Response / 响应:**
Returns matching skills with their details / 返回匹配的技能及其详细信息
3. get_skill_details / 获取技能详情
Get detailed information about a specific skill with context compression / 获取特定技能的详细信息，支持上下文压缩
**Parameters / 参数:**
- skill_id (required): Unique identifier of the skill / 技能的唯一标识符
- section (optional): What to return / 返回内容类型
- "summary" (default): Frontmatter + description snapshot (token-friendly) / 仅元数据和描述摘要（节省token）
- "instructions": Main instructions section only / 仅主要指令部分
- "examples": Code examples section only / 仅代码示例部分
- "full": Complete SKILL.md content / 完整内容
- max_lines (optional): Limit output to N lines / 限制输出行数
**Example / 示例:**
**Response / 响应:**
Returns skill information based on section parameter / 根据 section 参数返回技能信息
4. update_tags / 更新标签
Manage tags inside skills frontmatter / 管理 skills 的 frontmatter tags
**Parameters / 参数:**
- mode (required): "list" or "apply" / 操作模式："list" 或 "apply"
- updates (optional): required when mode is "apply" / 当 mode 为 "apply" 时需要提供
**Example / 示例:**
**Response / 响应:**
Returns the current tags list or operation result / 返回当前标签列表或操作结果
5. create_new_skill / 创建新技能
Create a new skill with automatic validation and indexing / 创建新技能并自动验证和索引
**Parameters / 参数:**
- path (required): Skill path (e.g., "coding/python-helper" or "simple-skill") / 技能路径
- description (required): Skill description (1-1024 characters) / 技能描述（1-1024字符）
- tags (optional): Array of tags / 标签数组
- instructions (optional): Custom instructions (if not provided, a template will be generated) / 自定义指令（如未提供则生成模板）
- license (optional): License information / 许可证信息
- metadata (optional): Metadata dict (e.g., {"author": "example", "version": "1.0"}) / 元数据字典
- create_scripts_dir (optional): Whether to create scripts/ directory / 是否创建 scripts/ 目录