MCP Server Demo

MCP サーバーのデモ

シェルスクリプトを介してアプリケーションをアップグレードするツール機能を提供する、Model Context Protocol（MCP）サーバー実装のシンプルなデモです。

概要

このプロジェクトでは、アプリケーションをアップグレードするカスタムツールを公開する FastMCP サーバーを実装しています。サーバーは stdio トランスポートで通信し、MCP 対応クライアントと統合できます。

機能

• アプリケーションをアップグレードするカスタムツールを備えた MCP サーバー
• subprocess を介したコマンド実行
• 環境変数による設定
• クライアントとサーバー間の通信に stdio トランスポートを使用

前提条件

• Python 3.12 以降
• uv パッケージマネージャー（依存関係の管理用）
• 環境変数の設定（COMMAND_FOLDER_PATH）

インストール

1. リポジトリをクローンします：

   git clone <repository-url>
   cd mcp-server-demo
   

2. uv を使用して依存関係をインストールします：

   uv pip install -e .
   

3. プロジェクトのルートに、次の内容を記述した .env ファイルを作成します：

   COMMAND_FOLDER_PATH=/path/to/your/command/folder
   

   コマンドフォルダーに update-apps.sh スクリプトが含まれていることを確認してください。

使用方法

サーバーは Python から直接実行できます：

python main.py

VS Code MCP 拡張機能での使用

用意されている mcp.json 設定を使用して、VS Code MCP 拡張機能を利用できます：

1. VS Code に MCP 拡張機能をインストールします
2. VS Code でプロジェクトを開きます
3. 「Connect to MCP Server」コマンドを使用し、「commander」サーバーを選択します

MCP Inspector での使用

MCP Inspector ツールを使用して MCP サーバーをテストおよび検査するには、次を実行します：

npx @modelcontextprotocol/inspector \
  uv \
  --directory ${PWD} \
  run \
  main.py

このコマンドを実行すると、MCP サーバーに接続する Inspector ツールが起動し、テスト目的で利用可能なツールを操作できます。

利用可能なツール

upgrade_apps

このツールは、COMMAND_FOLDER_PATH 環境変数で指定されたフォルダーにある update-apps.sh スクリプトを実行します。

クライアントでの使用例：

result = await client.upgrade_apps()
print(result)

プロジェクト構成

• main.py - メインのサーバー実装
• pyproject.toml - プロジェクトの依存関係とメタデータ
• .vscode/mcp.json - VS Code MCP の設定
• uv.lock - uv パッケージマネージャー用の依存関係ロックファイル
• .env - 環境変数（リポジトリには含まれていません）

依存関係

• mcp[cli] (>=1.6.0)
• python-dotenv（必須ですが、pyproject.toml には明示的に記載されていません）

開発

このプロジェクトでは、従来の pip と比べて依存関係の解決とインストールが高速な、Python パッケージ管理用の uv を使用しています。

依存関係を更新するには：

uv pip install -e .

ライセンス

[ライセンス情報をここに記載してください]

貢献

[貢献ガイドラインをここに記載してください]