fabric-mcp-server

fabric-mcp-server

目次

1. はじめに
2. Model Context Protocol（MCP）とは？
3. 機能
4. ツール
5. インストール
6. 使い方
7. Claude Desktop の設定
8. Cline を使用した VS Code の設定
9. さまざまな AI エージェントで使用する際のヒント
10. トラブルシューティング
11. コントリビューション
12. ライセンス

はじめに

fabric-mcp-server は、Daniel Miessler の Fabric のパターンをツールとして公開し、AI コーディングエージェントやアシスタントと連携できるように設計された Model Context Protocol（MCP）サーバーです。この連携により、Fabric リポジトリの AI 駆動型パターン実行を活用して、AI の機能を強化できます。このサーバーは、Claude Desktop、Cline、その他の MCP 対応 AI エージェントなど、さまざまな AI プラットフォームで動作します。

Model Context Protocol（MCP）とは？

Model Context Protocol（MCP）は、AI システムと外部ツールやリソースとの通信を容易にする仕様です。データベース、API、ファイルシステムなどのさまざまな機能と AI モデルが連携する方法を標準化します。fabric-mcp-server のような MCP サーバーはこのプロトコルを実装し、AI モデルがツールやリソースを利用できるようにすることで、その機能範囲を広げます。

機能

• Fabric パターンをツールとして公開：このサーバーは、すべての Fabric パターンを MCP 対応 AI エージェント内の個別のツールとして利用できるようにします。
• パターンの実行：ユーザーは、AI アシスタントのタスク内で Fabric パターンを直接選択して実行できます。
• 機能の強化：AI 駆動型のパターン実行を統合し、AI アシスタントの機能を強化します。
• クロスプラットフォーム対応：Claude Desktop、Cline、その他の MCP 対応 AI エージェントで動作します。

ツール

fabric-mcp-server は、幅広い Fabric パターンをツールとして公開します。例：

• analyze_claims
• summarize
• extract_wisdom
• create_mermaid_visualization
• その他多数…

利用可能なパターンの全一覧は、[fabric/patterns](https://github.com/danielmiessler/Fabric/tree/main/data/patterns) ディレクトリを一覧表示すると確認できます。

インストール

1. リポジトリをクローンする：fabric-mcp-server リポジトリをローカルシステムにクローンします。
2. 依存関係をインストールする：fabric-mcp-server ディレクトリに移動し、npm install を実行します。
3. プロジェクトをビルドする：npm run build を実行して TypeScript コードをコンパイルします。

使い方

fabric-mcp-server を AI エージェントで使用するには：

1. サーバーがインストールされ、実行中であることを確認します。
2. AI エージェントの設定ファイルで MCP サーバーを設定します。
3. 新しいタスクまたは会話を作成し、使用する Fabric パターンを選択します。

具体的な設定手順は、使用する AI エージェントによって異なります。詳しい手順については、以下のセクションを参照してください。

Claude Desktop の設定

Claude Desktop で fabric-mcp-server を使用するには、次の手順に従います。

1. インストールを完了する：上記のインストール手順に従って、プロジェクトをビルドします。

2. Claude Desktop を設定する：Claude Desktop の設定に MCP サーバーの構成を追加します。設定ファイルは通常、次の場所にあります。

   • Windows：%APPDATA%\Claude\claude_desktop_config.json
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux：~/.config/Claude/claude_desktop_config.json

3. サーバー構成を追加する：claude_desktop_config.json に次の内容を追加します。

{
  "mcpServers": {
    "fabric-mcp-server": {
      "command": "node",
      "args": [
        "<path-to-fabric-mcp-server>/build/index.js"
      ],
      "env": {}
    }
  }
}

<path-to-fabric-mcp-server> を、お使いのシステム上の fabric-mcp-server ディレクトリの実際のパスに置き換えます。

4. Claude Desktop を再起動する：変更を適用するため、Claude Desktop を再起動します。

VS Code の Cline の設定

VS Code の Cline で fabric-mcp-server を使用するには、次の手順に従います。

1. インストールを完了する：上記のインストール手順に従って、プロジェクトをビルドします。

2. Cline の設定を行う：Cline の設定ファイルに MCP サーバーの構成を追加します。ファイルのパスはオペレーティングシステムによって異なります。

   • Windows：C:\Users\<username>\AppData\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
   • macOS：~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
   • Linux：~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

3. サーバー構成を追加する：次の構成を使用します。

{
  "fabric-mcp-server": {
    "command": "node",
    "args": [
      "<path-to-fabric-mcp-server>/build/index.js"
    ],
    "env": {},
    "disabled": false,
    "autoApprove": [],
    "transportType": "stdio",
    "timeout": 60
  }
}

<path-to-fabric-mcp-server> を、お使いのシステム上の fabric-mcp-server ディレクトリの実際のパスに置き換えます。例：

• Windows："C:\\path\\to\\fabric-mcp-server\\build\\index.js"
• macOS/Linux："/path/to/fabric-mcp-server/build/index.js"

4. VS Code を再起動する：変更を適用するため、VS Code を再起動するか、Cline 拡張機能を再読み込みします。

さまざまな AI エージェントで使用する際のヒント

Claude Desktop を使用する場合

• 会話の中で、Fabric パターンを使いたいことを伝えるだけです。
• どのパターンを使えばよいかわからない場合は、利用可能なパターンを一覧表示するよう Claude に依頼します。
• 設定が完了すると、パターンはツールとして自動的に利用可能になります。

Cline を使用する場合

Cline で fabric-mcp-server のメリットを最大限に活用するには、プロンプトの末尾に use fabric-mcp-server を追加するか、次のルールを .clinerules ファイルに追加することを検討してください。

# Fabric MCP Server Rule
1. **List Fabric Patterns**: When a new task is created, list all pattern names from the Fabric repository.
2. **Prompt for Pattern Selection**: Ask the user to select one of the following options:
   a) Enter a pattern name from the list to use the `fabric-mcp-server` tool with the specified pattern.
   b) Choose not to use `fabric-mcp-server` for the task.

このルールにより、Cline で新しいタスクを行う際のツール選択プロセスが簡素化されます。

その他の MCP 対応エージェントを使用する場合

• MCP サーバーの設定方法について、使用する AI エージェントのドキュメントを確認してください。
• 基本的なサーバー構成は、上記の例と同様です。
• エージェントが MCP プロトコルとツールの実行をサポートしていることを確認してください。

トラブルシューティング

• AI エージェントの設定で fabric-mcp-server が正しく構成されていることを確認してください。
• サーバーが実行中で、到達可能であることを確認してください。
• コンソール出力にエラーメッセージがないか確認してください。
• build/index.js ファイルへのパスが正しく、アクセス可能であることを確認してください。
• Node.js がインストールされ、システムの PATH から利用できることを確認してください。

貢献

fabric-mcp-server への貢献を歓迎します。貢献方法のガイドラインについては、CONTRIBUTING.md ファイルを参照してください。

ライセンス

fabric-mcp-server は MIT License の下で公開されています。