Mc MCP

🚀 mc - mcp プロジェクト

mc - mcp は、特定のツールや機能を提供するRustベースのプロジェクトです。このプロジェクトを使用することで、ユーザーは特定のタスクを効率的に実行することができます。

🚀 クイックスタート

mc - mcp を使用するには、まずインストールが必要です。インストールが完了したら、新しいプロジェクトを初期化し、ツール定義を作成することができます。

📦 インストール

以下のコマンドを使用して、mc - mcp をインストールします。

cargo install mc-mcp-cli

インストールが完了したら、以下のコマンドを実行して、ヘルプ情報を取得できます。

mc-mcp --help

💻 使用例

基本的な使用法

新しいプロジェクトの初期化

新しい Cargo.toml ファイルを作成し、以下の内容を追加します。

[package]
name = "my-tool"
version = "0.1.0"
edition = "2021"

[dependencies]
tool-derive = { version = "0.1", features = ["runtime"] }

以下のコマンドを実行して、プロジェクトを初期化します。

cargo generate --from mc-mcp:init

ツール定義の作成

src/main.rs という名前のファイルを作成し、以下の内容を追加します。

use tool_sdk::prelude::*;

#[tool]
struct MyAwesomeTool;

impl Tool for MyAwesomeTool {
    fn name(&self) -> &'static str {
        "My Awesome Tool"
    }

    fn description(&self) -> Option<&'static str> {
        Some("Does something awesome.")
    }

    async fn run(
        &self,
        _context: Context,
        _args: Vec<String>,
    ) -> Result<ToolOutput, ToolError> {
        Ok(ToolOutput::success("Awesome!".to_string()))
    }
}

高度な使用法

ツール定義の埋め込み

Cargo.toml に以下の内容を追加します。

[workspace.dependencies]
tool_sdk = { path = "../mc-mcp" }

ツールの登録

src/main.rs ファイルの末尾に以下のコードを追加します。

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // ツールを登録する
    register_tool!(MyAwesomeTool);
    
    Ok(())
}

ツールの実行

以下のコマンドを実行して、ツールを実行します。

mc-mcp run --tool MyAwesomeTool

📚 ドキュメント

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

コアコンポーネント

• Domain Layer：コアのビジネスロジック、エンティティ、およびインターフェースを含みます。
• Application Layer：ユースケース、データ転送オブジェクト（DTO）を定義します。
• Infrastructure Layer：Qdrant、埋め込み生成器、ファイルシステムなどの外部システムとの統合を処理します。

依存関係管理

手動の依存性注入を使用し、厳格な内側への依存規則に従います。

use domain::repositories::UserRepository;
use infrastructure::qdrant::QdrantClient;

#[inject]
struct MyService {
    userRepository: UserRepository,
    vectorStore: QdrantClient,
}

開発

コード構造

プロジェクトのルートディレクトリにある Cargo.toml ファイルには、以下の内容が含まれている必要があります。

[workspace.members]
members = [
    "mc-mcp",
    "test-fixtures"
]

resolver = "2"

テスト

• 単体テスト：cargo test --lib を実行します。
• 統合テスト：プロジェクトのルートディレクトリで cargo test --test-integration を実行します。

設定管理

config.rs という名前のファイルを作成し、以下の内容を追加します。

#[derive(Debug, Clone, Figment)]
pub struct Settings {
    #[default(String::from("qdrant"))]
    pub qdrant_url: String,
    
    #[default(40_000)]
    pub max_open_files: usize,
}

依存関係管理

Cargo.toml に以下の内容を追加します。

[dependencies]
tokio = { version = "1.0", features = ["full"] }
clap = { version = "3.2", features = ["derive"] }
figment = "0.6"

プロジェクトへの貢献

コミット規則

以下のコミット規則に従ってください。

git add .
git commit -m "feat: 新機能の追加" # 新機能
git commit -m "fix: 既知の問題の修正" # 問題の修正
git push origin main

コードスタイル

rustfmt と cargo clippy を使用して、コードの一貫性と保守性を維持します。

ドキュメント参照

• Rust 公式ドキュメント
• Tokio 公式ドキュメント
• Clap 公式ドキュメント

📄 ライセンス

このプロジェクトは MIT ライセンスに従います。

詳細な情報については、プロジェクトの GitHub リポジトリを参照するか、メンテナンスチームに連絡してください。