MCP Engine

🚀 MCP エンジンプロジェクトドキュメント

MCP エンジン（MCPEngine）は、企業レベルのメッセージ処理システムの構築と管理に使用されるツールチェーンです。リソース管理、タスクスケジューリング、ログ記録、監視などの豊富な機能モジュールを提供し、企業のメッセージ処理プロセスを簡素化することを目的としています。

🚀 クイックスタート

MCP エンジンのインストール

pip を使用して MCP エンジンをインストールします：

pip install mcp-engine

最初のサービスの作成

以下は、簡単な MCP サービスの例です：

from mcpengine import MCPEngine

mcp = MCPEngine("First Service")

@mcp.tool()
def greet(name: str):
    return f"你好，{name}！"

if __name__ == "__main__":
    mcp.start()

サービスの実行

上記のスクリプトを実行します：

python first_service.py

✨ 主な機能

リソース管理

• データストレージ：MySQL、PostgreSQL などのリレーショナルデータベースや MongoDB などの NoSQL データベースなど、複数のデータソースの保存と検索をサポートします。
• ファイル管理：アップロード、ダウンロード、削除、ディレクトリ管理など、ファイルシステムの操作機能を提供します。

タスクスケジューリング

• ジョブ管理：定期的なタスクの定義と実行を許可し、時間トリガーやイベントトリガーなどの複数のトリガーをサポートします。
• 依存関係管理：タスク間の依存関係を処理し、タスクが正しい順序で実行されるようにします。

ログ記録と監視

• ログ収集：ELK スタックなどの複数のログサービスを統合し、集中化されたログ管理と分析を実現します。
• パフォーマンス監視：システムリソースの使用状況とタスクの実行状態を追跡するリアルタイム監視機能を提供します。

💻 使用例

基本的な使用法

簡単な電卓サービス

以下は、基本的な算術演算を行う簡単な MCP エンジンサービスの例です：

from mcpengine import MCPEngine

mcp = MCPEngine("Simple Calculator")

@mcp.tool()
def add(a: int, b: int):
    return a + b

@mcp.tool()
def subtract(a: int, b: int):
    return a - b

@mcp.tool()
def multiply(a: int, b: int):
    return a * b

@mcp.tool()
def divide(a: int, b: int):
    if b == 0:
        raise ValueError("Cannot divide by zero")
    return a / b

ファイルアップロードサービス

以下は、ファイルアップロードサービスの例です：

import os
from mcpengine import MCPEngine

mcp = MCPEngine("File Upload Service")

@mcp.tool()
def upload_file(path: str, content: bytes):
    try:
        with open(path, 'wb') as f:
            f.write(content)
        return f"文件已上传至路径：{path}"
    except Exception as e:
        raise ValueError(f"文件上传失败：{str(e)}")

@mcp.resource("file://{path}")
def get_file_content(path: str):
    if not os.path.exists(path):
        raise FileNotFoundError(f"文件 {path} 不存在")
    with open(path, 'rb') as f:
        return f.read()

📚 ドキュメント

アーキテクチャ設計

主要コンポーネント

1. コアエンジン：タスクスケジューリングやリソース管理など、MCP エンジンのコアロジックを処理します。
2. プラグインシステム：ユーザーが MCP エンジンの機能を拡張できるようにし、複数のデータソースやプロトコルの統合をサポートします。
3. 監視とログモジュール：リアルタイム監視とログ記録機能を提供し、診断と保守を容易にします。

コンポーネントの相互作用フロー

1. タスクの送信：ユーザーは MCP エンジンが提供する API を介してタスクを送信します。
2. 依存関係のチェック：コアエンジンはタスク間の依存関係をチェックします。
3. リソースの割り当て：タスクの要件に応じて計算リソースを割り当てます。
4. タスクの実行：各タスクは順番にまたは並列に実行されます。
5. 結果のフィードバック：タスクが完了すると、結果がユーザーに返されます。

プロジェクトアーキテクチャ図

貢献ガイド

コードの貢献方法

1. リポジトリのクローン：Git を使用して MCP エンジンのソースコードリポジトリをクローンします。
2. 機能ブランチの作成：新しい機能や修正ごとに独立したブランチを作成します。
3. コードの提出：コードを提出する際には、変更内容と理由を詳細に記載したコミットメッセージを含めてください。

問題の報告方法

プロジェクトの GitHub リポジトリを通じて問題を報告してください。明確な説明と必要なログやエラー情報を添付してください。

コミュニティとサポート

• GitHub リポジトリ：MCP エンジン
• 開発者メーリングリスト：mcengine-dev@lists.sourceforge.net
• 中国語コミュニティフォーラム：MCP エンジン討論エリア

📄 ライセンス

MCP エンジンは MIT ライセンスに準拠しており、ユーザーはコードを自由に使用、修正、配布することができます。