skill-mcp は何をしますか？
AIアシスタント向けの管理されたスキルファイルシステムを提供するModel Context Protocol（MCP）サーバーです。
概要
このMCPサーバーは、AIアシスタント（例：Claude Code、Cursor、Codex）が使用するスキルファイルを管理するためのサーバーです。MCPプロトコルを通じて、スキルの作成、読み取り、更新、削除、検索などの操作を提供します。
主な機能
- スキルのCRUD操作: スキルファイルの作成、取得、更新、削除
- スキル検索: キーワードやカテゴリに基づくスキルの検索
- カテゴリ管理: スキルをカテゴリ別に整理
- バージョン管理: スキルのバージョン履歴の追跡（オプション）
- MCPプロトコル準拠: すべてのMCP準拠クライアントと連携可能
はじめ方
前提条件
- Node.js 18以上
- npm または yarn
インストール
npm install -g @becrafter/skill-mcp
または、プロジェクトに追加：
npm install @becrafter/skill-mcp
設定
- スキルディレクトリを作成：
mkdir -p ~/.skills
- 環境変数を設定：
export SKILL_DIR=~/.skills
export MCP_PORT=3000
- サーバーを起動：
skill-mcp-server
AIアシスタントとの統合
AIアシスタント（例：Claude Code）でMCPサーバーを使用するには、設定ファイル（例：~/.claude/settings.json）に以下を追加します：
{
"mcpServers": {
"skill-mcp": {
"command": "skill-mcp-server",
"env": {
"SKILL_DIR": "~/.skills",
"MCP_PORT": "3000"
}
}
}
}
APIリファレンス
このサーバーは以下のMCPツールを提供します：
| ツール名 | 説明 | パラメータ |
|---|---|---|
list_skills | 利用可能なスキルの一覧を取得 | category (任意), tag (任意) |
get_skill | 特定のスキルの内容を取得 | skill_id (必須) |
create_skill | 新しいスキルを作成 | name (必須), content (必須), category (任意) |
update_skill | 既存のスキルを更新 | skill_id (必須), content (必須) |
delete_skill | スキルを削除 | skill_id (必須) |
search_skills | キーワードでスキルを検索 | query (必須) |
使用例
スキルの一覧表示：
{
"tool": "list_skills",
"parameters": {
"category": "development"
}
}
スキルの作成：
{
"tool": "create_skill",
"parameters": {
"name": "project-boilerplate",
"content": "# Project Boilerplate Skill\n\nこのスキルは新しいプロジェクトのテンプレートを生成します。\n\n## 使用方法\n1. `npm init` を実行\n2. 設定ファイルを追加\n3. ...",
"category": "templates"
}
}
スキルファイル形式
スキルはマークダウンファイルとして保存され、以下の構造を持ちます：
---
name: my-skill
version: 1.0.0
category: development
tags:
- nodejs
- react
author: user
created: 2024-01-01
---
# スキル名
スキルの説明...
## 使用方法
...
貢献
バグ報告や機能リクエストは、GitHub Issues までお願いします。
ライセンス
MIT