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