Tiger Skills MCP Server

🚀 Tiger Skills MCP Server

通过 Model Context Protocol（MCP）服务器，使用任何大语言模型（LLM）模拟Claude Skills。本项目旨在让通用代理具备特定领域的程序性知识，增强其解决复杂问题的能力。

🚀 快速开始

克隆并本地运行服务器

git clone git@github.com:timescale/tiger-skills-mcp-server.git

构建项目

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

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

基于 .env.sample 文件创建 .env 文件：

cp .env.sample .env

然后更新 .env 文件中的 GITHUB_TOKEN 值。

测试项目

使用MCP Inspector测试

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"
      }
    }
  }
}

✨ 主要特性

Skills简介

Skills 是模块化组件，通过提供特定功能、工作流程和领域专业知识，增强与MCP兼容的代理的能力。它们将通用代理转变为具备特定程序性知识的专业代理，而这些知识是任何模型都无法完全拥有的。项目目标是与Anthropic的技能格式完全兼容。更多详细信息请参阅其 Agent Skills Spec 及相关文档。

Skills规范概述

技能结构

Skills 是模块化、自包含的包，通过提供专业知识、工作流程和工具来扩展代理的能力。可以将其视为特定领域或任务的“入门指南”，它们将通用代理转变为具备特定程序性知识的专业代理。

Skills 提供的内容

1. 专业工作流程：特定领域的多步骤程序。
2. 工具集成：使用特定文件格式或API的说明。
3. 领域专业知识：公司特定的知识、模式和业务逻辑。
4. 捆绑资源：用于复杂和重复性任务的脚本、参考资料和资产。

技能剖析

每个技能都由一个必需的 SKILL.md 文件和可选的捆绑资源组成：

skill-name/
├── SKILL.md (必需)
│   ├── YAML前置元数据 (必需)
│   │   ├── name: (必需)
│   │   └── description: (必需)
│   └── Markdown说明 (必需)
└── 捆绑资源 (可选)
    ├── scripts/          - 可执行代码 (Python/Bash等)
    ├── references/       - 按需加载到上下文中的文档
    └── assets/           - 输出中使用的文件 (模板、图标、字体等)

SKILL.md（必需）

元数据质量：YAML前置元数据中的 name 和 description 决定了代理何时使用该技能。要明确说明技能的功能和使用时机，使用第三人称表述（例如 “This skill should be used when...” 而不是 “Use this skill when...”）。

捆绑资源（可选）

• 脚本 (scripts/)：用于需要确定性可靠性或反复编写的任务的可执行代码（Python/Bash等）。
  • 包含时机：当相同代码被反复编写或需要确定性可靠性时。
  • 示例：用于PDF旋转任务的 scripts/rotate_pdf.py。
  • 优点：节省令牌、确定性强，可在不加载到上下文中的情况下执行。
  • 注意：脚本可能仍需要被代理读取以进行修补或特定环境调整。
• 参考资料 (references/)：用于在工作时供代理参考的文档和参考材料，按需加载到上下文中以指导代理的流程和思考。
  • 包含时机：当代理在工作时需要参考某些文档时。
  • 示例：用于财务模式的 references/finance.md、公司保密协议模板的 references/mnda.md、公司政策的 references/policies.md、API规范的 references/api_docs.md。
  • 用例：数据库模式、API文档、领域知识、公司政策、详细工作流程指南。
  • 优点：保持 SKILL.md 简洁，仅在代理确定需要时加载。
  • 最佳实践：如果文件较大（超过10000字），在 SKILL.md 中包含grep搜索模式。
  • 避免重复：信息应只存在于 SKILL.md 或参考文件中，而不是两者都有。除非信息确实是技能的核心，否则优先使用参考文件存储详细信息，这样可以保持 SKILL.md 简洁，同时使信息易于发现，而不会占用上下文窗口。只在 SKILL.md 中保留必要的程序说明和工作流程指导，将详细的参考材料、模式和示例移到参考文件中。
• 资产 (assets/)：不打算加载到上下文中，而是用于代理生成的输出中的文件。
  • 包含时机：当技能需要在最终输出中使用的文件时。
  • 示例：品牌资产的 assets/logo.png、PowerPoint模板的 assets/slides.pptx、HTML/React样板代码的 assets/frontend-template/、排版字体的 assets/font.ttf。
  • 用例：模板、图像、图标、样板代码、字体、被复制或修改的示例文档。
  • 优点：将输出资源与文档分离，使代理能够在不将文件加载到上下文中的情况下使用它们。

渐进披露设计原则

Skills 使用三级加载系统来有效管理上下文：

1. 元数据（名称 + 描述） - 始终在上下文中（约100字）。
2. SKILL.md 主体 - 当技能触发时（少于5000字）。
3. 捆绑资源 - 按需由代理加载（无限制*）。

* 无限制是因为脚本可以在不读取到上下文窗口的情况下执行。

📦 安装指南

克隆项目

git clone git@github.com:timescale/tiger-skills-mcp-server.git

安装依赖并构建

./bun i

创建并配置 .env 文件

cp .env.sample .env

更新 .env 文件中的 GITHUB_TOKEN 值。

📚 详细文档

配置

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

local-directory-collection:
  # 存储在 `./skills` 目录中的本地技能集合。
  # 每个技能应位于其自己的子目录中，且包含 `SKILL.md` 文件。
  type: local_collection
  path: ./skills
local-individual-skill:
  # 存储在 `./skills/skill-name` 目录中的单个本地技能。
  type: local
  path: ./path-to/individual/skill-name
anthropic-github-collection:
  # 包含技能集合的GitHub仓库。
  # 每个技能应位于其自己的子目录中，且包含 `SKILL.md` 文件。
  type: github_collection
  repo: anthropics/skills
  # path: ./ # 此示例中不需要，因为技能位于仓库根目录
  # 可选：指定要忽略的技能/路径
  ignored_paths:
    - .claude-plugin
    - document-skills
  disabled_skills:
    - canvas-design
  # 设置 enabled_skills 将仅加载集合中指定的技能
  # enabled_skills:
  #   - frontend-design
  #   - webapp-testing
single-github-skill-example:
  # 包含单个技能的GitHub仓库。
  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

子代理任务执行

此MCP服务器（可选）提供了一个 subagent 工具，可用于将复杂任务分解为较小的子任务，每个子任务由其自己的代理实例处理。这对于需要多个步骤的任务非常有用，特别是当这些步骤可能需要在大语言模型上下文中处理大量数据时。

子代理将自动访问与 view 技能工具配置相同的技能集，并且能够（递归地）调用更多子代理。此外，可以提供一个 mcp.yaml 配置文件来指定可供子代理使用的其他工具。

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

子代理的MCP配置

创建一个 mcp.yaml 文件，指定子代理可访问的其他工具。默认情况下，该文件从根目录读取，或者你可以通过 MCP_PATH 环境变量指定不同的路径。

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

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