MCP

🚀 Poly MCP

Poly MCPは、11のモジュールにまたがる73のツールを備えた包括的なMCP（Model Context Protocol）サーバーです。これらのモジュールには、ファイルシステム操作、診断、スクリプト、時間管理、ネットワークユーティリティ、コンテキスト管理、git操作、ユーザー入力、エージェント中心のバージョン管理、セッションクリップボード、およびテキスト/データ変換が含まれます。

✨ 主な機能

1. ファイルシステムモジュール

スナップショット管理、検索、および一括編集を備えた高度なファイルおよびディレクトリ操作です。

• fs_read - ファイル内容を読み取ります（オプションで行範囲指定可）
• fs_write - ファイルに内容を書き込みます（オプションで行範囲指定可）
• fs_move - ファイルまたはディレクトリを移動します
• fs_copy - ファイルまたはディレクトリを再帰的にコピーします
• fs_create - ファイルまたはディレクトリを作成します
• fs_delete - ファイルまたはディレクトリを削除します
• fs_move_desktop - デスクトップディレクトリ内のアイテムを整理します
• fs_find - パターンマッチングでファイルを検索します
• fs_ld - 詳細なディレクトリリスト（ls -laのような）を表示します
• fs_stat - ファイル/ディレクトリのメタデータを取得します
• fs_permissions - Unixファイルのパーミッションを取得または設定します
• fs_watch - ファイル/ディレクトリの変更を監視します
• fs_snapshot - タイムスタンプ付きのバックアップを自動管理で作成します
• fs_tree - 深さ制御とパターンフィルタリングを備えた視覚的なディレクトリツリーを表示します
• fs_grep - 正規表現を使用してファイル内の内容を検索し、コンテキスト行を表示します
• fs_tail - ファイルの最後のN行を読み取ります
• fs_replace - 正規表現を使用してファイル内の内容を一括検索/置換し、ドライランサポート付きです

2. 診断モジュール

言語に依存しないエラーと警告の検出です。

• diagnostics_get - ファイルまたはプロジェクトのエラー/警告を取得します
• 適切な診断ツール（cargo、tsc、eslint、pylintなど）を自動検出します
• Rust、TypeScript/JavaScript、Python、C/C++をサポートします
• コンパイラ/リンターの出力を構造化JSONに解析します

3. サイレントモジュール

Bashスクリプトの実行とシステムリソースの監視です。

• silent_script - 引数、環境変数、およびタイムアウトを指定してBashスクリプトを実行します
• silent_resources - 詳細なプロセス情報を含めてGPU/RAM/CPUの使用状況を監視します
• GPU監視にnvidia-smiをサポートします
• リソース使用状況によるプロセスのフィルタリングとソートが可能です

4. 時間モジュール

時間管理、スケジューリング、およびタイムキーピングです。

• time_now - 複数の形式（Unix、ISO8601、RFC3339、カスタム）で現在のタイムスタンプを取得します
• time_sleep - 設定可能な期間だけ実行を遅延させます
• time_schedule - メモリ内のタスクスケジューラで、作成/キャンセル/リスト/ステータス操作が可能です
• time_timezone - IANAタイムゾーン間でタイムスタンプを変換し、利用可能なタイムゾーンをリスト表示します
• time_stopwatch - 名前付きのストップウォッチで、開始/停止/ラップ/リセット/ステータス/リスト操作が可能です
• time_timer - カウントダウンタイマーで、チェック/キャンセル/リスト操作が可能です
• time_alarm - 時間またはオフセットでアラームを設定し、チェック/キャンセル/リスト操作が可能です

5. ネットワークモジュール

HTTPリクエストとパッケージレジストリのクエリです。

• net_fetch - URLを取得し、自動的にHTMLをMarkdownに変換します
• net_cargo - crates.ioからRustパッケージの情報を取得します
• net_node - npmレジストリからNode.jsパッケージの情報を取得します
• net_python - PyPIからPythonパッケージの情報を取得します
• net_apt - APTパッケージの情報を取得します
• net_ping - ネットワーク接続性を統計情報付きでチェックします

6. コンテキストモジュール

LLMのトークンカウントとコンテキスト管理です。

• ctx_context - トークン使用量（合計/使用済み/残り）を追跡します
• ctx_compact - zlib/gzipアルゴリズムを使用してテキストを圧縮します
• ctx_remove - コンテキストをクリアし、使用量をリセットします
• ctx_token_count - さまざまなLLMプロバイダー（GPT-4、Claudeなど）のトークンをカウントします
• ctx_memory_store - データをメモリ内（プロセスのライフタイム）に保存します
• ctx_memory_recall - 保存されたデータを取得します
• ctx_estimate_cost - Anthropic、OpenAI、Ollama、GLMのAPIコストを推定します

7. Gitモジュール

libgit2を介した完全なgit操作です。

• git_status - ステージング済み/未ステージング/追跡されていないファイルを含むリポジトリのステータスを表示します
• git_diff - パッチ形式で変更を表示します
• git_commit - コミットを作成します
• git_branch - ブランチをリスト、作成、または削除します
• git_checkout - ブランチまたはコミットを切り替えます
• git_blame - 行ごとの作成者を表示します
• git_log - コミット履歴を表示します
• git_tag - タグ（軽量および注釈付き）を管理します

8. 入力モジュール

ユーザーとの対話および通知です。

• input_notify - ターミナルおよびデスクトップ通知を送信します
• input_prompt - 対話型のテキストプロンプト（ターミナルまたはMCP）を表示します
• input_select - 選択メニュー（ターミナルまたはMCP）を表示します
• input_progress - 進捗バーを表示します
• input_clipboard_read - システムクリップボードから読み取ります
• input_clipboard_write - システムクリップボードに書き込みます

9. Gitentモジュール

エージェント中心のバージョン管理トラッキングです。

• gitent_init - トラッキングセッションを初期化または接続します
• gitent_status - セッションと未コミットの変更を表示します
• gitent_track - ファイルの変更（作成/修正/削除/名前変更）を手動でトラッキングします
• gitent_commit - メッセージ付きでトラッキングされた変更をコミットします
• gitent_log - コミット履歴を表示します
• gitent_diff - 統一または構造化形式で差分を表示します
• gitent_rollback - 前のコミットにロールバックします（デフォルトでプレビューモード）

AIエージェントの操作中にファイルの変更をトラッキングし、コミットを作成し、履歴を表示し、ロールバック操作を行います。

10. クリップボードモジュール

トークンを節約するためのタグ付きのセッションベースのコピー/ペーストです。

• clip_copy_file - ファイルからテキストを（オプションで行範囲指定可）タグ付きでセッションクリップボードにコピーします
• clip_copy - 任意のテキストを直接タグ付きでセッションクリップボードにコピーします
• clip_paste_file - タグ付きの内容をファイルに貼り付けます（上書き/追加/先頭追加/行置換）
• clip_paste - タグ付きの内容を取得するか、保存されたすべてのエントリをメタデータ付きでリスト表示します
• clip_clear - 1つまたはすべてのクリップボードエントリをクリアします

11. 変換モジュール

テキストおよびデータ処理ユーティリティです。

• transform_diff - 2つのテキストまたはファイルを比較し、統一/インライン/統計出力を表示します
• transform_encode - base64、URL、16進数、HTMLエンティティをエンコード/デコードします
• transform_hash - テキストまたはファイルの暗号化ハッシュ（SHA256、SHA512、MD5、BLAKE3）を計算します
• transform_regex - 正規表現操作：マッチ、find_all、置換、分割、キャプチャグループの抽出
• transform_json - JSON操作：整形表示、最小化、検証、クエリ、マージ、キー、平坦化
• transform_text - テキスト変換：ケース変換、ソート/逆順/一意化/トリム/行番号付け、折り返し、切り捨て、統計
• transform_archive - zipおよびtar.gzアーカイブの作成、抽出、およびリスト表示

📦 インストール

cargo add poly-mcp

💻 使用例

Poly MCPは、stdio（デフォルト）とHTTPサーバーの2つのトランスポートモードをサポートしています。

Stdioモード（デフォルト）

stdin/stdoutを使用してサーバーを実行します（元のMCPの動作）。

poly-mcp

サーバーは、MCPプロトコルに従ってstdin/stdoutを介してJSON-RPC 2.0で通信します。これは、コマンドをパイプする場合や、stdio通信を期待するツールと統合する場合に便利です。

例:

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | poly-mcp

HTTPサーバーモード

特定のポートでHTTPサーバーとして実行します。

poly-mcp --server --port 3000

オプション:

• --server または -s - HTTPサーバーモードを有効にします
• --port <PORT> または -p <PORT> - バインドするポート（デフォルト: 3000）
• --host <HOST> - バインドするホスト（デフォルト: 127.0.0.1）

使用例:

# デフォルトのポート3000でサーバーを起動
poly-mcp --server

# カスタムポートでサーバーを起動
poly-mcp --server --port 8080

# すべてのインターフェースでサーバーを起動
poly-mcp --server --host 0.0.0.0 --port 3000

HTTPエンドポイント:

• POST / または POST /jsonrpc - JSON-RPC 2.0エンドポイント
• GET /health - ヘルスチェックエンドポイント

HTTPリクエストの例:

curl -X POST http://localhost:3000/jsonrpc \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "fs_read",
      "arguments": {"path": "/etc/hosts"}
    }
  }'

ヘルスチェック:

curl http://localhost:3000/health

MCPプロトコルメッセージ

初期化:

{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {}}

ツールのリスト:

{"jsonrpc": "2.0", "id": 2, "method": "tools/list", "params": {}}

ツールの呼び出し:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "fs_read",
    "arguments": {
      "path": "/path/to/file.txt"
    }
  }
}

ツール呼び出しの例

ファイルの読み取り

{
  "name": "fs_read",
  "arguments": {"path": "/etc/hosts"}
}

特定の行範囲の読み取り

{
  "name": "fs_read",
  "arguments": {
    "path": "/var/log/app.log",
    "lines": [[1, 10], [50, 60]]
  }
}

特定の行範囲への書き込み

{
  "name": "fs_write",
  "arguments": {
    "path": "/tmp/config.txt",
    "content": "# Header v2\nversion=2.0",
    "lines": [[1, 2]]
  }
}

スナップショットの作成

{
  "name": "fs_snapshot",
  "arguments": {
    "path": "/important/project",
    "max_snapshots": 5
  }
}

診断の実行

{
  "name": "diagnostics_get",
  "arguments": {"path": "./src"}
}

Bashスクリプトの実行

{
  "name": "silent_script",
  "arguments": {
    "script": "#!/bin/bash\necho 'Hello World'\nls -la",
    "timeout": 30
  }
}

リソースの監視

{
  "name": "silent_resources",
  "arguments": {
    "detailed": true,
    "process_filter": "rust"
  }
}

URLをMarkdownとして取得

{
  "name": "net_fetch",
  "arguments": {
    "url": "https://example.com",
    "convert_to_markdown": true
  }
}

最新のパッケージバージョンの取得

{
  "name": "net_cargo",
  "arguments": {
    "crate_name": "tokio",
    "action": "latest"
  }
}

トークンのカウント

{
  "name": "ctx_token_count",
  "arguments": {
    "text": "Your text here",
    "model": "gpt-4"
  }
}

APIコストの推定

{
  "name": "ctx_estimate_cost",
  "arguments": {
    "provider": "anthropic",
    "model": "claude-3-opus",
    "input_tokens": 1000,
    "output_tokens": 500
  }
}

Git操作

{
  "name": "git_status",
  "arguments": {"path": "."}
}

{
  "name": "git_commit",
  "arguments": {
    "message": "feat: add new feature",
    "author_name": "Developer",
    "author_email": "dev@example.com"
  }
}

通知の送信

{
  "name": "input_notify",
  "arguments": {
    "title": "Build Complete",
    "message": "Your project has been built successfully!",
    "type": "both",
    "urgency": "normal"
  }
}

クリップボード操作

{
  "name": "input_clipboard_write",
  "arguments": {"content": "Hello from Poly MCP!"}
}

Gitent操作

{
  "name": "gitent_init",
  "arguments": {"path": "./my-project"}
}

{
  "name": "gitent_track",
  "arguments": {
    "path": "src/main.rs",
    "change_type": "modify",
    "content": "fn main() { println!(\"Updated\"); }",
    "agent_id": "claude"
  }
}

{
  "name": "gitent_commit",
  "arguments": {
    "message": "Updated main function",
    "agent_id": "claude"
  }
}

{
  "name": "gitent_log",
  "arguments": {"limit": 10, "verbose": true}
}

{
  "name": "gitent_rollback",
  "arguments": {
    "commit_id": "abc123...",
    "execute": false
  }
}

📄 ライセンス

このプロジェクトは、MITライセンスの下でライセンスされています。

貢献について

貢献は大歓迎です！問題を開くか、プルリクエストを送信してください。