MCP Terminal Server

🚀 MCP ターミナルサーバー - Windows インストールガイド

MCP（モデルコンテキストプロトコル）は、外部ツールと AI-Client（ここでは Claude-AI）間の通信を可能にします。このプロジェクトでは、定義されたワークスペース内でシェルコマンドを実行するための MCP 互換ターミナルサーバーを設定しています。

🚀 クイックスタート

以下の手順に沿って、MCP ターミナルサーバーをWindows環境にインストールします。

✨ 主な機能

• MCP（モデルコンテキストプロトコル）を介して、外部ツールとAI-Client（Claude-AI）間の通信を可能にします。
• 定義されたワークスペース内でシェルコマンドを実行できます。

📦 インストール

Claude デスクトップ版のインストール

1. Claudeの公式ウェブサイトからClaude デスクトップ版をダウンロードしてインストールします。
2. Windows：インストーラーの手順に従って操作します。
3. アプリケーションを開き、ログインします。

第一步：uv のインストール

方法 1：独立インストーラー

PowerShell で以下のコマンドを実行します。

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

方法 2：PyPI

Python がインストールされている場合：

pip install uv  # または
pipx install uv

インストールが完了したら、ターミナルを再起動して uv が認識されるようにします。

第二步：MCP ディレクトリ構造の作成

PowerShell で以下のコマンドを実行します。

mkdir D:\path\to\mcp\servers\terminal_server
mkdir $env:USERPROFILE\mcp\workspace

• D:\path\to\mcp\servers\terminal_server：すべての MCP サーバーを保存します。
• $env:USERPROFILE\mcp\workspace：専用のワークスペースディレクトリです。

第三步：Python プロジェクトの作成

cd D:\path\to\mcp\servers\terminal_server
uv init

このコマンドは terminal_server ディレクトリ内で Python プロジェクトを初期化します。

第四步：仮想環境の設定

uv venv
.venv\Scripts\activate

このコマンドは、依存関係を分離するための仮想環境を作成してアクティブ化します。

第五步：必要なパッケージのインストール

uv add "mcp[cli]"

このコマンドは、Claude との通信を有効にするための MCP パッケージをインストールします。

第六步：MCP ターミナルサーバーの起動

uv run terminal_server.py

このコマンドは、仮想環境内のターミナルサーバーを起動します。

第七步：Claude デスクトップ版の設定

以下の場所にある Claude 設定ファイル を編集します。

C:\Users\<your-username>\AppData\Roaming\Claude\claude_desktop_config.json

以下の設定を追加します。

{
    "mcpServers": {
        "terminal": {
            "command": "C:\\path\\to\\uv.exe",
            "args": [
                "--directory", "D:\\path\\to\\mcp\\servers\\terminal_server",
                "run",
                "terminal_server.py"
            ]
        }
    }
}

最後のステップ：Claude デスクトップ版の再起動

再起動後、ハンマーアイコン が表示されれば、ツールが使用可能な状態になっています！🚀