Anaconda MCP

Anaconda MCP

anaconda mcp は、MCP 対応の AI コーディングアシスタントに conda 環境管理ツールを公開する CLI およびサーバーです。統合された MCP エンドポイントとして機能し、Claude、Cursor、VS Code などの AI アシスタントが、conda 環境、パッケージ、チャンネル設定を把握できるようにします。

📖 ドキュメント全文： anaconda.com/docs · 開発ガイド

---

前提条件

• Conda（Miniconda または Anaconda Distribution）

---

インストール

conda create -n anaconda-mcp anaconda-mcp
conda activate anaconda-mcp

---

pip または uvx によるインストール

Python 3.10–3.14 が必要です。

pip install anaconda-mcp

uvx anaconda-mcp@latest

前提条件： conda を別途インストールし、PATH から見つけられるようにする必要があります。pip と uvx には conda は含まれていません。conda が正しくインストールされていない場合、このサーバーが公開する conda ツールは動作しません。まず Miniconda または Anaconda Distribution をインストールしてから、以下の anaconda login と anaconda mcp terms accept の手順に従ってください。

重要： Anaconda MCP Server は conda 環境を MCP 互換の AI アシスタントに接続し、マシン上の環境やパッケージの作成、変更、削除を可能にします。接続する AI アシスタントを信頼し、マシン上で実際の操作を行えることを理解したうえでインストールしてください。インストールすることで、次の事項を了承したものとみなされます。（1）この MCP サーバーに接続する AI アシスタントは、Anaconda の製品またはサービスではなく、独立したサードパーティのモデルです。（2）意図しない変更や削除を含め、AI アシスタントが環境内で指示する操作について、Anaconda は一切責任を負いません。

---

Anaconda へのログイン

認証は必須です。有効な Anaconda ログインがない場合、サーバーは起動せず、ツール呼び出しも成功しません。

anaconda login

ブラウザーが開き、OAuth ログインが行われ、トークンがシステムのキーチェーンに保存されます。次回以降の起動では、保存されたトークンが自動的に使われます。

---

利用規約への同意

ツール呼び出しを成功させるには、Anaconda MCP の ベータ版利用規約への同意が必要です。

対話形式（推奨）：

anaconda mcp terms accept

非対話形式（CI／ヘッドレス）：

export ANACONDA_MCP_ACCEPTED_TERMS=true
export ANACONDA_MCP_ACCEPTED_TERMS_VERSION=2026-05-27

---

セットアップ

AI クライアントが Anaconda MCP を使用するように設定します。

anaconda mcp setup

対話形式のウィザードが起動し、対応クライアントを検出して適切な設定を書き込みます。対応クライアント：Claude Desktop、Claude Code、Cursor、Windsurf、VS Code、OpenCode、Kilo Code。

特定のクライアントを非対話形式で設定するには、次のコマンドを実行します。

anaconda mcp setup --client claude-code
anaconda mcp setup --client cursor --scope project
anaconda mcp setup --client kilo

Kilo Code の設定

Anaconda MCP はプレーンな kilo.json ファイル（グローバル設定は ~/.config/kilo/kilo.json、プロジェクト設定は .kilo/kilo.json）を書き込みます。Kilo Code はこのファイルを既存の kilo.jsonc とディープマージします。そのため、手書きのコメントは anaconda mcp setup を実行しても保持されます。重要： kilo.json 自体をコメント付きで手動編集した場合、anaconda mcp setup はそのファイルを解析できず、空のファイルとして扱って変更内容を破棄し、警告なしに上書きします。コメントは kilo.jsonc に記述してください。

---

クライアントの手動設定

AI クライアントを手動で設定する場合は、クライアントの MCP 設定 JSON にエントリを追加します。anaconda mcp setup コマンドは Python のパスを解決しますが、手動で記述する場合は環境の Python のフルパスが必要です。

Claude Code（.mcp.json）の設定例：

{
  "mcpServers": {
    "anaconda-mcp": {
      "type": "stdio",
      "command": "/path/to/anaconda3/envs/anaconda-mcp/bin/python",
      "args": ["-m", "anaconda_mcp", "serve"],
      "env": {}
    }
  }
}

必要に応じて、anaconda login と anaconda mcp terms accept を実行する代わりに、env 辞書を使って認証情報と利用規約への同意を渡すこともできます。

"env": {
  "ANACONDA_AUTH_API_KEY": "<your-api-key>",
  "ANACONDA_MCP_ACCEPTED_TERMS": "true",
  "ANACONDA_MCP_ACCEPTED_TERMS_VERSION": "2026-05-27"
}

API キーは Anaconda アカウント設定から取得できます。

⚠️ クライアントごとに JSON スキーマが異なります。 設定を手動で記述する場合は、クライアントの MCP ドキュメントをよく確認してください。フィールド名と構造は Claude Code、Cursor、VS Code などの間で異なります。

---

実験的：ana CLI

ana CLI は、Anaconda MCP ランタイムのインストールと環境のセットアップを自動的に行うため、専用の anaconda-mcp conda 環境のパスを管理する必要はありません。

ana mcp serve は、管理対象の Anaconda MCP ランタイムをインストールして実行します。Miniconda、Anaconda Distribution、またはユーザー向けの conda コマンドはインストールしません。ターミナル、ノートブック、その他のローカルツールから環境を有効化または確認する場合は、そのワークフロー用に conda を別途インストールして設定してください。

ana をインストールします：

curl -fsSL https://anaconda.sh/install.sh | sh

事前に anaconda login と anaconda mcp terms accept を実行して、認証を行い、TOS に同意する必要があります。

ana を使ってクライアントを手動で設定する場合は、次を使用します：

{
  "mcpServers": {
    "anaconda-mcp": {
      "type": "stdio",
      "command": "ana",
      "args": ["mcp", "serve"],
      "env": {}
    }
  }
}