Auggie MCP

🚀 Auggie MCP Server

最小限のMCPサーバーで、Auggie CLIを質問応答とコード実装のツールとして公開します。

🚀 クイックスタート

このサーバーは、Auggie CLIを利用した質問応答とコード実装を行うための最小限のMCPサーバーです。以下の手順に沿ってセットアップしてください。

✨ 主な機能

• ask_question: Auggieのコンテキストエンジンを介したリポジトリの質問応答。
• implement: リポジトリ内で変更を実装します。デフォルトではドライランモードです。

📦 インストール

必要条件

• Node.js 18+
• システムにPython 3.10+がインストールされていること（内部で使用されます。手動でのセットアップは不要）
• Auggie CLIがインストールされていること（auggie --versionを実行して確認） - インストールガイドを参照

認証 (AUGMENT_API_TOKEN)

Auggie CLIを介してトークンを取得します。

# Auggie CLIがインストールされ、PATHに含まれていることを確認
auggie --version

# サインイン（ブラウザが開きます）
auggie login

# トークンを表示
auggie --print-augment-token

トークンは以下のいずれかの方法で提供してください。

• Cursor/Claude設定（推奨）: サーバーのenvの下に設定します。

{
  "mcpServers": {
    "auggie-mcp": {
      "command": "npx",
      "args": ["-y", "auggie-mcp@latest"],
      "env": { "AUGMENT_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

• シェル環境（macOS/Linux）
  • 単一コマンドのための一時的な設定:

AUGMENT_API_TOKEN=YOUR_TOKEN npx -y auggie-mcp --setup-only

- 将来のシェルでも持続する設定（zsh）:

echo 'export AUGMENT_API_TOKEN=YOUR_TOKEN' >> ~/.zshrc
source ~/.zshrc

⚠️ 重要提示

トークンをソースコントロールにコミットしないでください。マシンごとの環境変数またはクライアントの安全な設定ストアを使用することをお勧めします。

💻 使用例

クライアントの設定

Cursor via npx

Cursor（グローバルまたはプロジェクトごと）でこのMCP設定を使用します。

{
  "mcpServers": {
    "auggie-mcp": {
      "command": "npx",
      "args": ["-y", "auggie-mcp@latest"],
      "env": { "AUGMENT_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

これにより、以下のことが行われます。

• ラッパーパッケージをダウンロードします。
• パッケージ内にローカルのPython仮想環境を作成します。
• requirements.txtをインストールします。
• stdioモードでPythonサーバーを起動します。

Quick test via npx (terminal)

# パッケージのローカル仮想環境に依存関係をインストール（グローバルインストールは行われません）
npx -y auggie-mcp --setup-only

# サーバーを実行（stdio）。簡単なスモークテストに便利です。
npx -y auggie-mcp

# オプション: 手動デバッグ用にHTTPモードを起動
npx -y auggie-mcp -- --http

Claude Desktop (macOS)

~/Library/Application Support/Claude/claude_desktop_config.jsonを編集して以下を追加します。

{
  "mcpServers": {
    "auggie-mcp": {
      "command": "npx",
      "args": ["-y", "auggie-mcp@latest"],
      "env": { "AUGMENT_API_TOKEN": "YOUR_TOKEN" }
    }
  }
}

セキュリティとパーミッション

• デフォルトでは、implementはドライランモードで実行されます。ファイルは書き込まれず、シェルは実行されません。提案された差分が表示されます。
• 書き込みを有効にするには、dry_run: falseを設定します。
• 推奨事項: 機能ブランチを使用し、マージする前に差分をレビューしてください。