Jarvis

🚀 Jarvis MCP Server

Model Context Protocol (MCP) を使用したAIアシスタント機能を備えた、包括的なシステムツール付きサーバーです。

🚀 クイックスタート

このMCPサーバーは、Model Context Protocolを通じてAIモデルとのシームレスな統合を可能にし、AIアシスタントとの対話やコンテキスト管理を標準化された方法で行えます。高いパフォーマンスと信頼性を備えたGo言語で構築されています。

✨ 主な機能

• MCPプロトコルサポート：mark3labs/mcp-goを使用したModel Context Protocolの完全実装
• セキュリティ重視の設計：設定可能なコマンドブロッキングとディレクトリアクセス制御
• システム統合：安全制御付きのターミナルコマンド実行
• ファイルシステム操作：安全なファイルの読み取り、書き込み、操作
• テキスト編集ツール：行ベースの操作による高度なテキスト編集機能
• HTTPフェッチツール：組み込みのウェブコンテンツ取得機能
• 設定管理：MCPツールを介したランタイム設定の更新
• Go言語による実装：堅牢なエラーハンドリングを備えた高性能なGo言語のサーバー

📦 インストール

前提条件

• Go 1.24.4以降
• Git

セットアップ

1. リポジトリをクローンします：

git clone (https://github.com/can-acar/jarvis)
cd jarvis

2. 依存関係をインストールします：

go mod download

3. プロジェクトをビルドします：

go build -o jarvis main.go

💻 使用例

サーバーの起動

./jarvis

サーバーが起動し、MCPプロトコルを使用してstdioを介して通信します。

設定

サーバーはconfig.yamlファイルを使用して設定されます：

# セキュリティ設定
blockedCommands:
  - rm
  - shutdown
  
# コマンド実行のデフォルトシェル
defaultShell: bash

# ファイル操作の許可ディレクトリ
allowedDirectories:
  - /tmp
  - /var/log

# ファイル操作の制限
fileReadLineLimit: 1000
fileWriteLineLimit: 50

# テレメトリ
telemetryEnabled: false

利用可能なツール

サーバーは以下のMCPツールを提供します：

設定ツール

• get-config - 現在のサーバー設定を取得します
• set-config - サーバー設定値を更新します

ターミナルツール

• execute-command - セキュリティ制御付きでシェルコマンドを実行します
• get-command-history - コマンド実行履歴を取得します

ファイルシステムツール

• read-file - ページネーションサポート付きでファイル内容を読み取ります
• write-file - ファイルに内容を書き込みます
• list-directory - ディレクトリ内容をリストします
• create-directory - 新しいディレクトリを作成します
• delete-file - ファイルやディレクトリを削除します
• move-file - ファイルやディレクトリを移動/リネームします
• file-info - ファイルのメタデータや情報を取得します

テキスト編集ツール

• edit-file - 複雑なテキスト編集操作を実行します
• search-replace - ファイル内のテキストを検索して置換します
• batch-edit - ファイルに複数の編集を適用します

フェッチツール

• fetch-url - ウェブURLからコンテンツを取得します
• download-file - リモートソースからファイルをダウンロードします

📚 ドキュメント

プロジェクト構造

jarvis/
├── main.go                    # メインサーバーエントリポイント
├── config.yaml               # サーバー設定
├── go.mod                    # Goモジュール定義
├── go.sum                    # Goモジュールチェックサム
├── handlers/                 # MCPツールハンドラー
│   ├── config_handler.go     # 設定管理
│   ├── terminal_handler.go   # ターミナル操作
│   ├── filesystem_handler.go # ファイルシステム操作
│   ├── textediting_handler.go # テキスト編集ツール
│   └── fetch_handler.go      # HTTPフェッチ操作
└── internal/                 # 内部パッケージ
    ├── common/               # 共有ユーティリティ
    ├── config/               # 設定管理
    ├── terminal/             # ターミナルユーティリティ
    ├── filesystem/           # ファイルシステムユーティリティ
    ├── textedit/             # テキスト編集ユーティリティ
    ├── fetch/                # フェッチユーティリティ
    └── types/                # 型定義

ビルドとテスト

# プロジェクトをビルドします
go build -o jarvis main.go

# テストを実行します
go test ./...

# 詳細なログを表示して実行します
go run main.go

# 異なるプラットフォーム用にビルドします
GOOS=windows GOARCH=amd64 go build -o jarvis.exe main.go
GOOS=linux GOARCH=amd64 go build -o jarvis-linux main.go

カスタムツールの追加

新しいMCPツールを追加するには：

1. 適切なハンドラーファイルにハンドラー関数を作成します：

func HandleNewTool(ctx context.Context, req mcp.CallToolRequest) (*mcp.CallToolResult, error) {
    // ここに実装を記述します
    return mcp.NewToolResultText("Result"), nil
}

2. 対応する内部パッケージでツールを登録します：

func RegisterNewTools(s *server.MCPServer) {
    s.AddTool("new-tool", "Description", map[string]interface{}{
        "type": "object",
        "properties": map[string]interface{}{
            "param": map[string]interface{}{
                "type": "string",
                "description": "Parameter description",
            },
        },
        "required": []string{"param"},
    }, handlers.HandleNewTool)
}

3. main.goで登録関数を呼び出します。

コントリビューション

1. リポジトリをフォークします
2. 機能ブランチを作成します：git checkout -b feature-name
3. 変更を加え、テストを追加します
4. コードがGoの規約に沿っていることを確認します：go fmt ./...
5. テストを実行します：go test ./...
6. 変更をコミットします：git commit -m 'Add feature'
7. ブランチにプッシュします：git push origin feature-name
8. プルリクエストを提出します

🔧 技術詳細

セキュリティに関する考慮事項

• コマンドはサニタイズされ、ブロックされるパターンと照合されます
• ファイルシステムへのアクセスは許可されたディレクトリに制限されます
• コマンド実行にはタイムアウト制御が含まれています
• すべての操作は監査目的でログに記録されます
• 設定により危険な操作を制限することができます

依存関係

• mark3labs/mcp-go：Go用のMCPプロトコル実装
• google/uuid：UUID生成
• spf13/cast：型キャストユーティリティ

APIドキュメント

MCPプロトコルの実装

サーバーは以下のMCP機能を実装しています：

• ツール：システム操作（ファイル入出力、ターミナルコマンドなど）を実行します
• リソース：適切なアクセス制御付きでファイルシステムリソースにアクセスします
• プロンプト：テンプレートベースのプロンプト管理

ツールカテゴリ

1. システムツール：ターミナルコマンド実行、プロセス管理
2. ファイルツール：セキュリティ境界付きのファイル操作
3. テキストツール：高度なテキスト操作と編集
4. ネットワークツール：HTTPリクエストとコンテンツ取得
5. 設定ツール：ランタイム設定管理

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

サポート

サポートや質問については：

• GitHubでイシューを作成します
• ドキュメントやコードのコメントを確認します
• 既存のイシューやディスカッションを確認します

パフォーマンスに関する注意事項

• 高い並行性とパフォーマンスを備えたGo言語で構築されています
• 設定可能な制限付きの効率的なファイル操作
• 大きなファイルの処理に対応したメモリを意識した設計
• stdioを介したMCPプロトコル通信に最適化されています