AI Configuration Setup

AI 設定のセットアップ

このプロジェクトの目標は次のとおりです。

1. AI ツール向けの AI 設定（ルール、コマンド、MCP サーバー）の管理を簡素化する
2. 開発者が AI 設定の信頼できる唯一の情報源を維持できるようにする
3. グローバル設定とプロジェクト固有の設定の両方について、簡単なセットアップ手順を提供する

仕組み

ルール、コマンド、MCP サーバーの設定を格納した単一の設定ディレクトリを使用します。1 つのスクリプトで、両方の AI ツールに適した場所へ設定を反映できます。

⚠️ これは MacOS で構築・テストされています。現在、Windows と Linux はサポートされていません。追加の作業が必要なためです。

サポート対象の AI ツール 🛠️

AI ツール	設定	MCP サーバー	プロジェクトスコープ	グローバルスコープ
Copilot	詳細	🚧 (Cursor のもの)	❌	✅
Claude Code	詳細	✅	❌	✅
Cursor	詳細	✅	✅ (シンボリックリンク)	❌

使い方

1. 設定ディレクトリをセットアップし、ルール、コマンド、MCP サーバーの設定を追加します。
2. scripts/setup --help を実行して、すべてのオプションを確認します。セットアップする設定を指定できます。
3. 適切なフラグを指定して scripts/setup を実行し、AI 設定を適切な場所に反映します。

必要に応じて、scripts/reset を実行して設定をリセットできます。これにより、すべてのシンボリックリンクが削除され、グローバルに設定されたファイルも削除されます。セットアップスクリプトは冪等なので、通常は必要ありません。

設定ディレクトリの構成

設定ディレクトリ（デフォルトは ~/ai_configs）には、ルール、コマンド、MCP サーバーの設定を格納します。setup スクリプトの実行時に AI_CONFIGS_DIR 環境変数を設定すると、ディレクトリを変更できます。

~/ai_configs/
├── rules/                   # Directory containing rule files (.mdc)
│   ├── rule1.mdc
│   └── rule2.mdc
├── commands/                # Directory containing command files (.mdc)
│   ├── command1.mdc
│   └── command2.mdc
└── mcp-servers-config.json  # Configuration for MCP servers

ルールとコマンドは .mdc ファイルとして記述する点に注意してください。これらのファイルは scripts/setup スクリプトで使用され、AI ツール向けの適切な設定ファイルが作成されます。

.mdc ファイルの例

---
description: JavaScript coding standards for the project
globs: ["*.js", "*.jsx", "*.ts", "*.tsx"]
alwaysApply: false
---

You are a helpful AI assistant for JavaScript programming tasks. Always focus on readability and maintainability.

一部の AI ツールでは .mdc ファイルを使用しない場合もありますが、内容を保持するためにファイルをそのまま置き、.md ファイルとしてコピーします。

mcp-servers-config.json の例

{
  "fetch": {
    "type": "stdio",
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
}

AI ツールごとの詳細

Copilot の設定

• グローバルルール：ルールは VSCode の設定（~/Library/Application Support/Code/User/settings.json）にある github.copilot.chat.codeGeneration.instructions キーに設定します。

  • ユーザーの settings.json は JSON5 形式のため、値を変更する信頼できる方法（たとえば jq を使用する方法）がありません。そのため、2 つのマーカーキーの間をすべて置き換えるための マーカー 方式を使用しています。

    "__AI_TOOL_COPILOT_START": true,
    "github.copilot.chat.codeGeneration.instructions": [{"text":"rule1 content"},{"text":"rule2 content"},],
    "__AI_TOOL_COPILOT_END": true,
    

• グローバルコマンド：コマンド（.mdc ファイル）は prompt.md 拡張子で ~/Library/Application Support/Code/User/prompts にコピーされます。

• MCP サーバー：現在、サーバー設定は構成されませんが、VSCode は Cursor の MCP 設定を利用できます。

Claude Code の設定

• グローバルルール：ルール（.mdc ファイル）は ~/.claude/CLAUDE.md に連結されます。
• グローバルコマンド：コマンド（.mdc ファイル）は .md 拡張子で ~/.claude/commands/ にコピーされます。
• MCP サーバー：サーバー設定（mcp-servers-config.json として定義）は ~/.claude.json に追加されます。

Cursor の設定

• プロジェクトベースのルール：ルールディレクトリは、プロジェクト内の .cursor/rules/local/rules にシンボリックリンクされます（pwd に基づきます）。
• プロジェクトベースのコマンド：コマンドディレクトリは、プロジェクト内の .cursor/rules/local/commands にシンボリックリンクされます（pwd に基づきます）。
• MCP サーバー：サーバー設定（mcp-servers-config.json として定義）は ~/.cursor/mcp.json にコピーされます。

Cursor の制限事項

Cursor は現在、グローバルルールではなく、プロジェクトベースのルールのみをサポートしています。つまり、次のようになります。

• ルールとコマンドは、使用する各プロジェクトディレクトリで設定する必要があります。
• このツールは、プロジェクトディレクトリ内にルールとコマンドへのシンボリックリンクを作成します。
• 設定ファイルへの変更は、シンボリックリンクによりプロジェクトに自動的に反映されます。

バージョン管理システムで、追加されたローカルの Cursor ルール **/.cursor/rules/local/** をグローバルに無視するよう設定するとよいでしょう。

冪等な更新

scripts/setup は冪等になるよう設計されているため、問題なく複数回実行できます。これは次のような場合に便利です。

• 設定ディレクトリ内のルールやコマンドを変更した場合
• プロジェクトベースの設定を新しいプロジェクトディレクトリに適用する場合
• MCP サーバーの設定を更新する必要がある場合

Cursor のプロジェクトベースの設定では、ルールファイルやコマンドファイルはシンボリックリンクされているため、変更はプロジェクトに自動的に反映されます。変更を反映するためにセットアップスクリプトを再実行する必要はありません。