Angreal MCP Server

Angreal MCP サーバー

angreal プロジェクトの検出機能を AI アシスタントに提供する MCP（Model Context Protocol）サーバーです。

概要

このサーバーは angreal のコマンドツリー構造を MCP 対応クライアントに公開し、AI アシスタントが以下を行えるようにします。

• angreal プロジェクトで利用可能なコマンドやタスクを検出する
• プロジェクトの構造と機能を理解する
• コンテキストに基づいて適切なコマンドを提案する

前提条件

• angreal がインストールされ、PATH から利用できること
• Rust ツールチェーン（ソースからビルドする場合）

インストール

# Install from crates.io
cargo install angreal_mcp

# Or install from git (latest development version)
cargo install --git https://github.com/colliery-io/angreal-mcp

使い方

Claude Code を使う場合

~/.config/claude-code/mcp_servers.json にある Claude Code の MCP 設定ファイルを作成または更新します。

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "env": {}
    }
  }
}

Claude Desktop を使う場合

Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "cwd": "/path/to/your/angreal/project"
    }
  }
}

Cline（VS Code）を使う場合

Cline の設定に追加します。

{
  "mcp": {
    "servers": [
      {
        "name": "angreal",
        "command": ["angreal_mcp"],
        "cwd": "${workspaceFolder}"
      }
    ]
  }
}

コマンドラインでのテスト

コマンドラインから MCP サーバーを直接テストできます。

# List available tools
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | angreal_mcp

# Get angreal command tree
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "angreal_tree", "arguments": {"format": "json"}}}' | angreal_mcp

利用可能なツール

angreal_check

現在のディレクトリが angreal プロジェクトかどうかを確認し、利用可能なコマンドを含むプロジェクトのステータスを取得します。

angreal_tree

プロジェクトで利用可能なすべての angreal コマンドとタスクの構造化された表示を取得します。

パラメーター：

• format（任意）：出力形式 — "json"（デフォルト）または "human"

angreal_run

任意の引数を指定して、angreal コマンドまたはタスクを実行します。

パラメーター：

• command（必須）：実行する angreal コマンドまたはタスク
• args（任意）：追加の引数とフラグ

エージェントの利用ガイド

angreal プロジェクトで作業する際は、コマンドの検出と実行を効率よく行うために、これらのツールを使用します。

ツール利用のワークフロー

1. 検出から開始する：angreal_check を使用して、プロジェクトのステータスと機能を確認します
2. コマンドを確認する：angreal_tree を使用して、詳細なメタデータとともに利用可能なコマンドを確認します
3. 適切に実行する：コンテキストに応じてパラメーターを選択し、angreal_run を使用します

ベストプラクティス

• angreal_tree の when_to_use と when_not_to_use のガイダンスを必ず確認します
• より良い結果を得るには、パラメーターの推奨事項（recommended_when）を使用します
• コマンドを実行する前に前提条件を確認します
• コマンドの出力と終了コードを参考に、成功したかどうかを確認します

一般的なパターン

• セットアップのワークフロー：ビルドやテストのコマンドを実行する前に、セットアップやインストールのコマンドを実行します
• 開発サイクル：コード変更後にテストコマンドを使用し、デプロイ前にビルドコマンドを実行します
• パラメーターの選択：デバッグ時は詳細表示フラグを、リリース時は本番用フラグを使用します

トラブルシューティング

• MCP サーバーが利用できなくなった場合は、Claude Code を再起動して再初期化します
• angreal バイナリがインストールされ、PATH からアクセスできることを確認します
• angreal プロジェクトのディレクトリ（.angreal/ フォルダーを含む）にいることを確認します

angreal MCP サーバーは、使用コンテキスト、パラメーターのガイダンス、インテリジェントな分類などの拡張コマンドメタデータを提供し、自動化に関するより適切な判断を可能にします。

開発

テストの実行

このプロジェクトでは、テストランナーとして angreal を使用します。

# Run tests using angreal
angreal test

プロジェクト構成

angreal_mcp/
├── src/
│   ├── main.rs      # Main server loop
│   ├── mcp.rs       # MCP protocol implementation
│   └── angreal.rs   # Angreal integration
├── examples/        # Configuration examples
└── tests/          # Integration tests

ビルド

# Debug build
cargo build

# Release build
cargo build --release

ライセンス

このプロジェクトは、MIT または Apache-2.0 のデュアルライセンスで提供されています。