tiger-skills

Tiger Skills MCP サーバー

Model Context Protocol（MCP）サーバーを介して、任意の LLM で Claude Skills をエミュレートします。

Skills とは？

Skills は、特定の機能、ワークフロー、ドメインの専門知識を提供することで、MCP 互換エージェントの能力を高めるモジュール式コンポーネントです。汎用エージェントを、どのモデルも完全には備えられない手順に関する知識を持つ、特化型エージェントへと変えます。

目標は、Anthropic のスキル形式との完全な互換性を実現することです。詳しくは、Anthropic の Agent Skills 仕様と関連ドキュメントをご覧ください。

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.)

設定

環境変数

• 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

サブエージェントによるタスク実行

この MCP サーバーは、複雑なタスクを小さなサブタスクに分割し、それぞれを独自のエージェントインスタンスで処理するために使用できる subagent ツールを（任意で）提供します。これは、複数の手順が必要なタスク、特にそれらの手順で LLM のコンテキストに大量のデータを取り込む必要がある場合に便利です。

サブエージェントは、view スキルツール用に設定されたものと同じスキルセットに自動的にアクセスでき、さらに別のサブエージェントを（再帰的に）呼び出すこともできます。また、mcp.yaml 設定ファイルを用意すると、サブエージェントが利用できる追加のツールを指定できます。

サブエージェントを使用しない場合は、環境変数に SUBAGENT_DISABLED=true を設定して、このツールを無効にできます。

サブエージェント用の MCP 設定

サブエージェントが利用できる追加のツールを指定するには、mcp.yaml ファイルを作成します。このファイルはデフォルトでルートディレクトリから読み込まれますが、環境変数 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 ベースの UI から 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"
      }
    }
  }
}