Ultimate MCP Server

🚀 UMCP（Uniform Model Context Protocol）

UMCP（Uniform Model Context Protocol）は、様々なインテリジェントツールと大規模言語モデル（LLMs）を実行および管理するための強力で柔軟かつ安全な環境を提供する、統一されたモデルコンテキストプロトコルフレームワークです。標準化されたインターフェースとプロトコルを通じて、UMCPは開発者が複数のAIツールとサービスを簡単に統合できるようにし、同時にシステムの安全性と拡張性を確保します。

🚀 クイックスタート

UMCPは、様々なAIツールと大規模言語モデルを管理するための統一的な環境を提供します。以下のセクションでは、UMCPの機能、コンポーネント、インストール方法、実行方法などについて詳しく説明します。

✨ 主な機能

核心機能

• 多モデルサポート：主流のLLMプロバイダー（OpenAI、Anthropic、Google、DeepSeek、xAIなど）と互換性があります。
• コンテキスト管理：統一されたプロトコルにより、ツールとモデル間のやり取り方法を定義します。
• ファイル操作：Excel、JSON、CSVなどの様々なファイル形式をサポートし、安全にファイルの読み書きができます。
• データ処理：テキスト分析、データクリーニング、変換などの強力なデータ処理能力を備えています。
• ネットワークリクエスト：HTTP/HTTPSリクエストをサポートし、外部のAPIやサービスとのやり取りが可能です。
• コマンドラインツール：ファイルシステム、データベース、その他のリソースを操作するための豊富なコマンドラインツールを提供します。

安全特性

• 権限制御：ツールのアクセス権限を厳格に制限し、デフォルトでは指定されたディレクトリの読み書きのみを許可します。
• 入力検証：すべてのユーザー入力に対して厳格な型チェックとサニタイズを行い、注入攻撃を防止します。
• ログ記録：詳細な監査ログをサポートし、操作記録の追跡が容易です。
• 依存関係管理：サードパーティライブラリの既知の脆弱性を自動的に検出して修復します。

🔧 技術詳細

1. プロトコル定義

UMCPは、標準化されたプロトコルにより、ツールとモデル間のやり取り方法を定義します。このプロトコルはJSON - RPC 2.0を拡張したもので、AIツールとサービスに特化して最適化されています。

2. ツールエコシステム

UMCPは、ファイル処理、ネットワークリクエスト、データ処理などの複数の分野にわたる豊富な組み込みツールを提供します。

• Filesystem Tools：ファイルシステムを安全に操作するためのツールです。
• Browser Tools：Playwrightを使用してブラウザの自動化を実現します。
• SQL Tools：SQLAlchemyを使用してデータベースとのやり取りを行います。
• Excel Tools：OpenPyXLを基にExcelファイルを処理します。
• Text Processing Tools：Tesseract、ripgrep、jqなどのテキスト分析と処理をサポートします。

3. 安全メカニズム

UMCPは、デフォルトでいくつかの安全対策を有効にしています。

• ディレクトリ制限：ALLOWED_DIRS 設定により、ファイル操作の範囲を制限します。
• 入力検証：すべてのツール入力は厳格な型チェックとサニタイズを経ます。
• 最小権限モード：プロセスは非特権ユーザーとして実行され、権限の乱用を防止します。

📦 インストール

クイックインストール

pip install umcp

全量依存関係管理

uv sync

環境設定

config.py ファイルを編集します。

class Settings:
    DEBUG: bool = False
    LOG_LEVEL: str = "INFO"
    ALLOWED_DIRS: list[str] = ["/path/to/allowed/directory"]
    DEFAULT_WORK_DIR: str = "/tmp/umcp-workdir"

💻 使用例

サーバーの実行

デフォルトモード

umcp run

SSEモード（Webとリモートクライアントに推奨）

umcp run --sse

カスタム設定

umcp run --config custom_config.py

サポートされるツール

組み込みツールリスト

• Filesystem Operations：安全なファイルの読み書きとディレクトリ管理。
• Browser Automation：Playwrightを使用したウェブページの自動化。
• Database Queries：SQLAlchemyを使用したデータベース操作。
• Excel Processing：OpenPyXLを基にしたExcelファイルの処理。
• Text Analysis：Tesseract、ripgrep、jqなどの様々なテキスト処理ツールをサポート。

サードパーティ統合

UMCPは以下のサービスとの統合をサポートしています。

• HTTP/HTTPS API
• クラウドストレージ（S3, GCS, Azure Blob Storage）
• メッセージキュー（RabbitMQ, Kafka）

安全上の注意事項

デフォルトの安全ポリシー

• 任意のコードの実行を禁止します。
• ファイル操作のディレクトリ範囲を制限します。
• 入力検証と出力のサニタイズをデフォルトで有効にします。

高度な安全機能

• アクセス制御：ロールベースの権限管理（RBAC）。
• 監査ログ：すべての敏感な操作を記録します。
• 侵入検知：異常な行動をリアルタイムで監視します。

📄 ライセンス

UMCPはオープンソースソフトウェアで、MITライセンスの下で提供されています。完全なライセンス情報を確認するには、以下のコマンドを実行します。

cat LICENSE

謝辞

UMCPに技術的なサポートを提供してくれた以下のプロジェクトとライブラリに感謝します。

• Playwright：強力なブラウザ自動化ツール。
• SQLAlchemy：機能豊富なORMツール。
• OpenPyXL：Excelファイル処理ライブラリ。
• Tesseract：オープンソースのOCRエンジン。

詳細な情報については、公式ドキュメント を参照するか、コミュニティディスカッショングループ に参加してください。