Vscode MCP Python

🚀 MCPサーバ - モデルコンテキストプロトコルサーバ

VSCodeとClaudeを統合するための本番環境対応型MCP（モデルコンテキストプロトコル）サーバです。包括的なツールサポート、パフォーマンスモニタリング、診断機能を備えています。

バージョン

現在のバージョン: 1.0.0
リリース日: 2026年1月13日
ステータス: 開発中

✨ 主な機能

⚡ 技術的な最適化

• トークンオーバーヘッドの削減: 大規模なデータセットをチャットに貼り付ける代わりに、MCPサーバはClaudeが必要な特定のデータのみをクエリできるようにします。これにより、応答が高速化し、コストとトークン使用量が削減されます。
• 非同期実行: Pythonの非同期機能を活用することで、サーバは複数のデータ要求を同時に処理し、インタラクションを凍結させることなく動作します。
• カスタムツールマッピング: pandas、beautifulsoup、osなどの複雑なPythonライブラリを、Claudeが即座に呼び出せる簡単なツールにラップすることができます。

🌟 プロジェクトに付与される価値

• ギャップを埋める: Claudeを単なる「チャットボット」から、実際にローカルのコードやデータベースを閲覧および変更できる「開発者エージェント」に変えます。
• ワークフローの自動化: Claudeと会話するだけで、ログ分析、ローカルファイルの整理、データベースクエリなどの繰り返し作業を自動化できます。
• プライベートデータコンテキスト: サーバはローカルで実行されるため、プライベート文書や社内データのコンテキストをClaudeに提供でき、それらのファイルをクラウドにアップロードする必要はありません。

核心機能

• 10のプロフェッショナルプロセス - 完全なファイル操作、コード分析、VSCode統合
• LRUキャッシング - パフォーマンスを2 - 3倍に向上させるためのインテリジェントなリクエストキャッシング
• 型安全性 - 100%型ヒント（PEP 484準拠）
• エンタープライズアーキテクチャ - SOLID原則、デザインパターン、プロフェッショナルな構造
• 包括的なロギング - デバッグ用のstderrへの構造化ロギング
• エラーハンドリング - 特定の例外を持つ本番環境対応型のエラーハンドリング

📦 インストール

前提条件

• Python 3.8以上
• VSCode（VSCode統合機能を使用する場合、オプション）
• Windows、Linux、またはmacOS

セットアップ

1. このリポジトリをクローンまたはダウンロードします。

2. すべてのファイルが同じディレクトリにあることを確認します。

   • mcp_server.py - メインサーバ
   • tools.py - ツールの実装
   • vscode_detector.py - VSCode統合
   • diagnostics.py - ヘルスチェック
   • performance_monitor.py - パフォーマンス追跡
   • languages.json - 言語設定

3. あなたの人工知能デスクトップ（Claude用）をこのサーバを使用するように設定します（設定セクションを参照）。

クイックスタート

# サーバのコンパイルテスト
python -m py_compile mcp_server.py

# 診断を実行
python diagnostics.py

# サーバを起動（通常はClaudeによって呼び出されます）
python mcp_server.py

設定

Claudeデスクトップの設定ファイルに追加します。

Windows

%APPDATA%\Claude\claude_desktop_config.json

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

設定例

{
  "mcpServers": {
    "vscode-mcp": {
      "command": "python",
      "args": ["C:\\path\\to\\mcp_server.py"]
    }
  }
}

💻 使用例

ファイルの読み取り

ユーザー: "mcp_server.pyの内容を読み取って"
Claude: read_fileツールを使用
結果: ファイルの内容が表示される

コード分析

ユーザー: "tools.pyのコードを分析して"
Claude: analyze_codeツールを使用
結果: 関数、クラス、インポートが行番号付きで一覧表示される

コードの作成

ユーザー: "Pythonの電卓を作成して"
Claude: write_code_to_projectツールを使用
システム: 許可プロンプトが表示される
ユーザー: 承認
結果: calculator.pyが作成され、詳細なフィードバックが表示される

コードの修正

ユーザー: "calculator.pyのdivide関数にエラーハンドリングを追加して"
Claude: change_codeツールを使用
システム: 許可プロンプトが表示される
ユーザー: 承認
結果: 関数が更新され、変更前後のプレビューが表示される

プロジェクトの概要

ユーザー: "プロジェクト構造を表示して"
Claude: get_project_structureツールを使用
結果: プログラミング言語別にファイルが整理されて表示される

📚 詳細ドキュメント

主要コンポーネント

MCPServerクラス

• MCP 2024-11-05を実装するプロトコルハンドラ
• JSON-RPC 2.0通信
• 非同期/待機パターン
• リクエスト/レスポンス管理

ToolRegistryクラス

• ツールの登録と管理
• 入力スキーマの検証
• ツールの呼び出し

RequestCacheクラス

• LRUキャッシングメカニズム
• キャッシュサイズの設定可能
• 自動削除

LanguageConfigクラス

• 言語設定の管理
• コード分析のためのパターンマッチング
• ファイル拡張子の処理

デザインパターン

• レジストリパターン - ツール管理
• キャッシュパターン - リクエストキャッシング
• データクラスパターン - 型安全なメタデータ
• 依存性注入 - 設定管理
• ストラテジーパターン - ツール実行

パフォーマンス

最適化機能

• 安全なツールリクエストのためのLRUキャッシュ
• 非ブロッキング操作のための非同期/待機
• 効率的なファイルシステムスキャン
• スマートなVSCodeプロセス検出
• 最小限のメモリ使用量

パフォーマンス指標

診断

ヘルスチェック

包括的な診断を実行します。

# 完全な診断セット
python diagnostics.py

# クイックチェック
python diagnostics.py --mode quick

# ヘルスステータス（JSON）
python diagnostics.py --mode health

診断テスト

• Pythonバージョンの互換性
• 必要なファイルの存在
• ファイルの権限
• 設定の有効性
• モジュールのインポート
• 構文チェック
• ディスク容量
• メモリ使用量
• VSCodeのステータス
• ネットワーク接続

開発

コード品質基準

• PEP 8 - スタイルガイドの遵守
• PEP 257 - ドキュメント文字列の規約
• PEP 484 - 型アノテーション
• Googleスタイル - ドキュメント文字列の形式

テスト

# すべてのファイルの構文チェック
python -m py_compile *.py

# 診断を実行
python diagnostics.py

# ツールのインポートテスト
python -c "import tools; import mcp_server"

トラブルシューティング

一般的な問題

サーバが起動しない

• Pythonバージョンを確認します: python --version（3.8以上である必要があります）
• 診断を実行します: python diagnostics.py
• 構文をチェックします: python -m py_compile mcp_server.py

ツールが機能しない

• ファイルの権限を確認します
• languages.jsonが有効なJSONであることを確認します
• インポートテストを実行します: python -c "import tools"

VSCodeの検出に失敗する

• VSCodeが実行中であることを確認します
• プロセスの権限を確認します（Windows）
• ワークスペースディレクトリがアクセス可能であることを確認します

権限エラー

• 必要に応じて管理者として実行します
• ファイル/ディレクトリの権限を確認します
• 設定内のパスを確認します

コード貢献ガイドライン

1. PEP 8スタイルガイドに従います
2. すべての関数に型ヒントを追加します
3. 包括的なドキュメント文字列を記述します
4. エラーハンドリングを含めます
5. 新機能に対してテストを追加します
6. 新しいツールについてREADMEを更新します

新しいツールの追加

1. tools.pyにツール関数を実装します
2. mcp_server.pyのTOOL_DEFINITIONSにツール定義を追加します
3. main()関数でツールを登録します
4. READMEドキュメントを更新します
5. 必要に応じて診断チェックを追加します

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください

サポート

ドキュメント

• コードのドキュメント文字列に完全なAPIリファレンスがあります
• このREADMEに使用例があります
• トラブルシューティングのための診断ツールがあります

ヘルプの取得

1. 診断を実行します: python diagnostics.py
2. stderr出力のログを確認します
3. エラーメッセージを注意深く確認します
4. 設定ファイルを確認します

クレジット

作者: Kommandant バージョン: 1.0.0
ライセンス: MIT
ステータス: 開発中