Snippets MCP

🚀 Snippets MCP

• このMCPサーバーは、セマンティック検索と従来のキーワードマッチングを使って、コードスニペットの保存、検索、管理を行います。
• コーディングエージェント（claude code、cursor、cline、opencodeなど）に特定のスニペットを保存するように指示するだけです。
• 必要なときには、あなたのクエリに関連するコードスニペットを検索するように指示するだけです。

✨ 主な機能

• AI埋め込みを使用したセマンティック検索で、キーワードだけでなく意味でスニペットを検索できます。
• セマンティック類似性とキーワードマッチングを組み合わせたハイブリッド検索。
• 自動プログラミング言語検出。
• タグベースの整理とフィルタリング。
• 日付範囲フィルタリング。
• データベース不要。JSONベースの保存方式。
• 高速検索のためにベクトル埋め込みをキャッシュ。

📦 インストール

npm install @freakynit/snippets-mcp

💻 使用例

add-snippet

データベースに新しいコードスニペットを追加します。

パラメータ:

• code (文字列、必須) - コード内容
• tags (配列、オプション) - タグ文字列の配列
• language (文字列、オプション) - プログラミング言語（指定されない場合は自動検出）
• description (文字列、オプション) - セマンティック検索を改善するためのテキスト説明

search-snippets

ハイブリッドセマンティックとキーワードマッチングを使用してスニペットを検索します。

パラメータ:

• query (文字列、オプション) - 自然言語の検索クエリ
• tags (配列、オプション) - 特定のタグでフィルタリング（AND論理）
• language (文字列、オプション) - プログラミング言語でフィルタリング
• dateStart (ISO日付文字列、オプション) - 作成日の開始日でフィルタリング
• dateEnd (ISO日付文字列、オプション) - 作成日の終了日でフィルタリング
• limit (数値、オプション) - 返す最大結果数（デフォルト: 10）

update-snippet

既存のスニペットを更新します。コード、タグ、または説明が変更された場合、埋め込みを再生成します。

パラメータ:

• id (文字列、必須) - スニペットID
• updates (オブジェクト) - 更新するフィールド（コード、タグ、言語、説明）を含むオブジェクト

delete-snippet

データベースからスニペットを削除します。

パラメータ:

• id (文字列、必須) - スニペットID

get-snippet

IDで単一のスニペットを取得します。

パラメータ:

• id (文字列、必須) - スニペットID

📚 ドキュメント

環境変数

1. SNIPPETS_FILE_PATH: オプション。スニペットと埋め込みを保存するファイルの完全パス。デフォルトは ~/.snippets-mcp-db.json です。

動作原理

このライブラリはハイブリッド検索アプローチを使用しています。

1. セマンティック検索 (70%の重み) - all-MiniLM-L6-v2 モデルを使用して、コード、説明、タグ、言語から生成された埋め込みに対してベクトル検索を行います。
2. キーワードマッチング (30%の重み) - コードとタグに基づく正確な用語のマッチングのための従来のテキストマッチング。
3. ハードフィルター - 最初に適用され、タグ、言語、日付範囲で結果を絞り込みます。

埋め込みは、スニペットの追加/更新時に一度生成され、高速検索のためにキャッシュされます。

保存方法

スニペットは、環境変数 SNIPPETS_FILE_PATH で指定されたJSONファイル、またはデフォルトパスの ~/.snippets-mcp-db.json に以下の構造で保存されます。

{
  "id": "uuid",
  "code": "string",
  "language": "string",
  "tags": ["array"],
  "description": "string",
  "embedding": [/* ベクトル配列 */],
  "createdAt": "ISO日付",
  "updatedAt": "ISO日付"
}

mcpServers jsonを使用した設定

MacとLinuxの場合

{
  "mcpServers": {
    "snippets-mcp": {
      "command": "npx",
      "args": ["-y", "@freakynit/snippets-mcp@latest"],
      "env": {
        "SNIPPETS_FILE_PATH": "オプション... スニペットと埋め込みを保存するパス... .json拡張子が必要"
      }
    }
  }
}

Windowsの場合

{
  "mcpServers": {
    "snippets-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@freakynit/snippets-mcp@latest"],
      "env": {
        "SNIPPETS_FILE_PATH": "オプション... スニペットと埋め込みを保存するパス... .json拡張子が必要"
      }
    }
  }
}

📄 ライセンス

MIT