Neoforge MCP Server

🚀 ターミナルコマンドランナー MCP サーバー

強力なモデル制御プロトコル（MCP）サーバーで、RESTful API インターフェースを通じて AI アシスタントにターミナルコマンドの実行とファイルシステム管理機能を提供します。

✨ 主な機能

ターミナル管理

• 設定可能なタイムアウト付きのコマンドを実行
• バックグラウンドで長時間実行されるプロセスを管理
• アクティブなコマンドセッションから出力を取得
• すべてのアクティブなセッションとシステムプロセスをリスト表示
• プロセスを終了または強制終了
• コマンドブラックリスト機能（セキュリティ対策）

ファイルシステム操作

• ファイルの読み取りと書き込み
• ディレクトリの作成
• ディレクトリの内容をリスト表示
• ファイルの移動/名前変更
• glob パターンを使用したファイル検索
• 詳細なファイル情報の取得

高度な機能

• 精密なテキスト編集（検索と置換を含む）
• システム情報の取得
• 数学式の計算

🚀 クイックスタート

前提条件

• Python 3.13+
• uv パッケージマネージャー（推奨）

インストール

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

git clone https://github.com/neoforge-dev/neoforge-mcp-server.git
cd python-server-mcp

2. 仮想環境を作成し、依存関係をインストールします：

uv venv
source .venv/bin/activate  # Windows 環境下：.venv\Scripts\activate
uv pip install -e .

3. MCP サーバーを起動します：

python server.py

サーバーは http://0.0.0.0:8000 で実行されます。

🧪 テスト

このプロジェクトには、機能を検証するための包括的なテストスイートが含まれています：

# テスト用の依存関係をインストール
uv pip install -r requirements.txt

# すべてのテストを実行
./run_tests.py

# カバレッジレポートを生成してテストを実行
./run_tests.py --coverage

# 詳細な出力でテストを実行
./run_tests.py --verbose

# 特定のテストファイルを実行
./run_tests.py --test tests/test_command_execution.py

テストスイートは以下の内容をカバーしています：

• コマンドの実行とプロセス管理
• ファイルシステム操作
• システムユーティリティ
• セキュリティ機能

🔧 設定

Cursor を構成するには、MCP サービスを ~/.cursor/mcp.json ファイルに追加します：

{
  "mcpServers": {
    "NeoMCP": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/python-server-mcp/server.py"
      ]
    }
  }
}

📚 ドキュメント

ターミナルツール

• execute_command：タイムアウト設定付きのコマンド実行
• read_output：実行中のプロセスの出力を取得
• force_terminate：実行中のコマンドを停止
• list_sessions：すべてのアクティブなコマンドセッションを表示
• list_processes：すべてのシステムプロセスを表示
• kill_process：PID でプロセスを強制終了
• block_command：コマンドをブラックリストに追加
• unblock_command：コマンドをブラックリストから削除

ファイルシステムツール

• read_file：ファイルの内容を読み取る
• write_file：ファイルにデータを書き込む
• create_directory：新しいディレクトリを作成
• list_directory：ディレクトリの内容をリスト表示
• move_file：ファイルを移動または名前を変更
• 詳細なファイル情報の取得

高度なツール

• 精密なテキスト編集（検索と置換を含む）
• システム情報の取得
• 数学式の計算

🤝 コントリビューションガイド

コントリビューションを歓迎します！ 参加方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは LICENSE によって保護されています。