MCP Tool Kit

🚀 MCP ツールキット

MCPツールキットは、人間とAIの間に認知的なパートナーシップを構築するツールです。人間の戦略的思考能力とAIの操作能力を相補い、新しい人机協調モデルを提供します。

🚀 クイックスタート

このセクションでは、MCPツールキットのインストール、設定、起動までの手順を説明します。

📦 インストール

リポジトリのクローン

以下のコマンドを使用して、MCPツールキットのリポジトリをクローンします。

git clone git@github.com:your-username/mcp-tool-kit.git
cd mcp-tool-kit

依存関係のインストール

以下のコマンドを実行して、プロジェクトに必要なPythonの依存関係をインストールします。

pip install -r requirements.txt

環境変数の設定（Windows）

Gitをシステムパスに追加するには、以下の手順に従います。

1. 「システムの環境変数の編集」アプリケーションを開きます。コントロールパネルから、または「システムの環境変数の編集」を検索して見つけることができます。
2. 「システム変数」セクションで、「Path」変数を見つけて「編集...」をクリックします。
3. Gitのインストールディレクトリのパスを追加します（例：C:\Program Files\Git\bin と C:\Program Files\Git\cmd）。
4. 変更を保存した後、新しいPATH設定を適用するためにコマンドプロンプトウィンドウを再開きます。

サービスの起動

以下のコマンドを実行して、MCP統一サーバーを起動します。

python mcp_unified_server.py

📚 ドキュメント

設定ガイド

すべてのAPIキーと設定パラメータをconfig.jsonファイルに追加します。

{
  "news_api_key": "your-news-api-key",
  "world_bank_api_key": "your-world-bank-api-key",
  "git_path": "C:\\Program Files\\Git\\bin"
}

ツールの拡張

新しいツールモジュールの追加

1. toolsディレクトリの下に新しいPythonファイルを作成します（例：my_tool.py）。
2. 既存のモジュールのパターンに従って機能を実装します。
   • サービスクラスを作成する
   • ツール関数を定義する
   • 登録関数を実装する
3. mcp_unified_server.pyを更新して、新しいモジュールをインポートして登録します。

既存のツールモジュールの拡張

1. サービスクラスに新しいメソッドを追加します。
2. ツール関数で新しい機能を実装します。
3. 登録関数を更新して、新しいツールを含めます。

Docker開発環境

Dockerを使用して開発することで、環境の一貫性を保証できます。

# 開発用イメージのビルド
docker build -t mcp-tool-kit:dev .

# 開発モードでコンテナを実行
docker run -p 8000:8000 \
    -v $(pwd):/app \
    -v ~/documents:/app/documents \
    mcp-tool-kit:dev

このコマンドは、ローカルのコードとドキュメントディレクトリをコンテナにマウントするため、コードの変更はすぐに反映されます（ほとんどのファイルについて）。

哲学的視点：人間と機械の認知パートナーシップ

MCPツールキットは、人間と人工知能の関係におけるパラダイムシフトを表しています。AIを単なるタスク自動化ツールとして見るのではなく、認知的なパートナーシップを築きます。ここでは、人間の戦略的思考能力とAIの操作能力が相補います。

このエージェントアーキテクチャは、変革的なビジョンを体現しています。AIシステムは、独立してコンテキストを解釈し、限定されたパラメータ内で決定を下し、複雑な操作シーケンスを実行することができます。同時に、人間の監督と戦略的指導を維持します。これは単なる技術的進歩ではなく、人間と機械の協調の新しいモデルです。

この発展する認知的な状況では、最も成功した実装は、技術的な可能性と人間の能力を慎重にバランスさせるシステムです。人間の意思決定と創造力を強化し、代替しないインターフェースを作成します。

トラブルシューティング

• モジュールが読み込まれない：インポートパスと依存関係を確認する
• APIキーのエラー：.envファイルの設定を検証する
• Gitパスの問題：システムPATHに正しく追加されていることを確認する
• 起動に失敗する：ログ出力を確認して詳細なエラー情報を取得する

拡張読書

MCPツールキットの機能と使い方を深く理解するために、以下のリソースを参照することをお勧めします。

1. 公式ドキュメント
2. 開発者ブログ
3. コミュニティフォーラム

これらのガイドに従えば、MCPツールキットをスムーズに設定して使用できるはずです。途中で問題が発生した場合は、トラブルシューティングセクションを参照するか、サポートチームに問い合わせてください。