tiger-skills

Tiger Skills MCP Server

通过 Model Context Protocol（MCP）服务，让任何大模型都能模拟 Claude Skills。

什么是 Skills？

Skills 是模块化组件，可通过提供特定功能、工作流和领域专业知识，增强兼容 MCP 的 Agent 的能力。它们能将通用 Agent 转变为专业 Agent，使其具备任何模型都无法完全掌握的程序性知识。

我们的目标是完全兼容 Anthropic 的技能格式。有关详情，请参阅其 Agent Skills Spec 和相关文档。

skill-name/
├── SKILL.md (required)
│   ├── YAML frontmatter metadata (required)
│   │   ├── name: (required)
│   │   └── description: (required)
│   └── Markdown instructions (required)
└── Bundled Resources (optional)
    ├── scripts/          - Executable code (Python/Bash/etc.)
    ├── references/       - Documentation intended to be loaded into context as needed
    └── assets/           - Files used in output (templates, icons, fonts, etc.)

这些文件不会加载到上下文中，而是用于 Agent 生成的输出。

• 适用场景：技能需要在最终输出中使用文件时
• 示例：用于品牌资源的 assets/logo.png、用于 PowerPoint 模板的 assets/slides.pptx、用于 HTML/React 样板代码的 assets/frontend-template/、用于字体排版的 assets/font.ttf
• 使用场景：模板、图片、图标、样板代码、字体、会被复制或修改的示例文档
• 优点：将输出资源与文档分开，使 Agent 无需将文件加载到上下文中即可使用

渐进式披露设计原则

技能采用三级加载系统，高效管理上下文：

1. 元数据（名称 + 描述） - 始终处于上下文中（约 100 个单词）
2. SKILL.md 正文 - 技能触发时加载（少于 5k 个单词）
3. 捆绑资源 - Agent 按需加载（无限*）

*之所以是无限，是因为脚本可以执行，而无需读入上下文窗口。

配置

环境变量

• SKILLS_FILE：配置技能集合的 YAML 文件路径。默认值：./skills.yaml
• SKILLS_TTL：缓存已加载技能的时间（毫秒）。默认值：5 分钟

技能配置文件

技能集合通过 YAML 文件配置。支持本地目录和 GitHub 仓库。配置可以指向单个技能，也可以指向技能集合。

local-directory-collection:
  # A collection of local skills stored in the `./skills` directory.
  # Each skill should be in its own subdirectory with a `SKILL.md` file.
  type: local_collection
  path: ./skills
local-individual-skill:
  # An individual local skill stored in the `./skills/skill-name` directory.
  type: local
  path: ./path-to/individual/skill-name
anthropic-github-collection:
  # A GitHub repo containing a collection of skills.
  # Each skill should be in its own subdirectory with a `SKILL.md` file.
  type: github_collection
  repo: anthropics/skills
  # path: ./ # not needed for this example since skills are at the root of the repo
  # Optionally specify skills/paths to ignore in this collection
  ignored_paths:
    - .claude-plugin
    - document-skills
  disabled_skills:
    - canvas-design
  # Setting enabled_skills will _only_ load the specified skills from the collection
  # enabled_skills:
  #   - frontend-design
  #   - webapp-testing
single-github-skill-example:
  # A GitHub repo containing an individual skill.
  type: github
  repo: anthropics/claude-cookbooks
  path: ./skills/custom_skills/creating-financial-models

所有已配置技能的名称必须唯一。重复项将被忽略，并显示警告。

连接字符串参数

客户端可以通过连接字符串中的参数控制启用的技能集合以及使用的协议。

• enabled_skills：要启用的技能键，以逗号分隔。若未提供，则启用所有已配置的技能。
• disabled_skills：要禁用的技能键，以逗号分隔。若未提供，则不禁用任何技能。
• tools=0：禁用所有工具（用于仅资源集成）。
• resources=0：禁用所有资源（用于仅工具集成）。

示例

http://tiger-skills-mcp-server/mcp?disabled_skills=foo,bar&resources=0

子 Agent 任务执行

此 MCP 服务（可选）提供一个 subagent 工具，可用于将复杂任务拆分为较小的子任务，分别交由独立的 Agent 实例处理。这适用于需要多个步骤的任务，尤其是这些步骤可能需要在大模型上下文中处理大量数据时。

子 Agent 将自动获得与 view 技能工具相同的技能，并能够（递归地）调用更多子 Agent。此外，还可以提供 mcp.yaml 配置文件，指定要提供给子 Agent 的其他工具。

如果不想使用子 Agent，可以在环境中设置 SUBAGENT_DISABLED=true 来禁用该工具。

子 Agent 的 MCP 配置

创建 mcp.yaml 文件，指定子 Agent 可使用的其他工具。默认从根目录读取此文件，也可以通过环境变量 MCP_PATH 指定其他路径。

目前仅支持可流式传输的 HTTP 传输方式。

pg_aiguide:
  type: http
  url: https://mcp.tigerdata.com/docs

开发

在本地克隆并运行服务。

git clone [email protected]:timescale/tiger-skills-mcp-server.git

构建

运行 ./bun i 安装依赖并构建项目。使用 ./bun watch 在更改时重新构建。

你需要一个具有正确权限范围的 GitHub 令牌。可通过此直接链接创建新令牌。

根据 .env.sample 文件创建 .env 文件。

cp .env.sample .env

然后更新 .env 中的 GITHUB_TOKEN 值。

测试

MCP Inspector 非常方便，可通过基于 Web 的界面测试 MCP 服务。

./bun inspector

通过 HTTP 测试

./bun watch http

通过 stdio 测试

./bun watch stdio

在 Claude Desktop 中测试

创建或编辑文件 ~/Library/Application Support/Claude/claude_desktop_config.json，添加如下条目，并确保使用本地 tiger-skills-mcp-server 项目的绝对路径，以及有效的 GitHub 令牌。

{
  "mcpServers": {
    "tiger-skills": {
      "command": "node",
      "args": [
        "/absolute/path/to/tiger-skills-mcp-server/dist/index.js",
        "stdio"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_whatever"
      }
    }
  }
}