mcp-stama: AIエージェント向け高性能Rust MCPサーバー

mcp-stamaは、単一の静的バイナリを通じてAIコーディングエージェントにローカルコンテキストを提供するよう設計された、Rust製の高性能なModel Context Protocol (MCP) サーバーです。Node.jsやPythonのランタイムに関連するオーバーヘッドを排除することで、コールドスタートアップ時間を数秒から2ミリ秒未満に短縮し、メモリ使用量を数百メガバイトから10MB未満に削減します。

パフォーマンス・ベンチマーク

mcp-stamaは、主要なリソース指標のすべてにおいて、Node.jsやPythonで構築された従来のMCPサーバーを大幅に上回ります。ネイティブなRust実装を利用することで、ほぼ瞬時の実行と最小限のシステムへの影響を実現します。

Metric	Legacy MCP Servers (Node / Python)	mcp-stama (Rust)
Cold Startup Time	1,500ms – 3,000ms	< 2ms
p50 Execution Latency	150ms – 800ms	300µs – 5ms
Memory Footprint (RSS)	180 MB – 350 MB	< 10 MB
Dependencies	100+ packages	Zero external runtimes
Installation	Requires Node.js / Python setup	Single static binary

内部のマイクロベンチマークでは、特定のツールについてさらなる効率性が示されています：

Tool Name	Invocations	p50 Latency	p99 Latency	Memory Footprint (RSS)
docker_watcher	100	327 µs	1.66 ms	< 10 MB
git_snapshot	100	462 µs	1.36 ms	< 10 MB
fast_grep	100	5.05 ms	8.72 ms	< 10 MB

内蔵の高性能ツール

mcp-stamaは、重い子プロセスを生成したりプロンプトトークンを浪費したりすることなく、AIエージェントに深いローカルコンテキストを提供するよう設計された、いくつかの特化型ツールを含んでいます。

fast_grep

このツールは、ミリ秒未満のファイル検索と正規表現スキャンを提供します。ignore::WalkBuilderを利用して、バイナリファイルや隠しファイルをスキップしながら、.gitignoreや.ignoreファイルを自動的に尊重します。

git_snapshot

gix (gitoxide)によって駆動される、純粋なRust製のGitインスペクターです。HEADコミット、ブランチ情報、行の差分、およびファイルステータスをネイティブに取得するため、外部のgit実行ファイルを呼び出す必要がありません。

docker_watcher

このツールは、bollardとsysinfoを使用して、ホストおよびコンテナの即時診断を提供します。実行中のDockerコンテナ、システムのメモリ、CPUコア、およびマッピングされたポートをAIエージェントに可視化させます。

インストールと設定

mcp-stamaは単一の静的バイナリとして配布され、AIエディタとの統合を簡素化するための自動設定機能が含まれています。

インストール

• macOS / Linux: curl -fsSL https://raw.githubusercontent.com/StamManif/mcp-stama/main/install.sh | sh
• Windows (PowerShell): iwr -useb https://raw.githubusercontent.com/StamManif/mcp-stama/main/install.ps1 | iex
• Cargo: cargo install mcp-stama

自動設定

ユーザーは、以下のフラグを使用して、エディタの設定にサーバーを自動的に注入できます：

• Claude Desktop: mcp-stama --install-claude
• Cursor: mcp-stama --install-cursor

手動設定

手動設定の場合は、対応する設定ファイル（Cursorの場合は~/.cursor/mcp.json、Claude Desktopの場合はclaude_desktop_config.json）に以下を追加してください：

{
  "mcpServers": {
    "mcp-stama": {
      "command": "mcp-stama",
      "args": []
    }
  }
}

技術アーキテクチャ

mcp-stamaは、Pure Stdio JSON-RPC 2.0インターフェースを実装しています。JSON-RPCフレームプロトコルを厳密に遵守するため、すべての診断およびログ出力はstderrにルーティングされ、stdoutがプロトコル通信専用に維持されることを保証します。

リクエストフローは線形パスに従います： AI Client (Cursor/Claude) $\rightarrow$ StdioTransport $\rightarrow$ JsonRpcRequest/Response $\rightarrow$ ToolRegistry $\rightarrow$ Specific Tool (fast_grep, git_snapshot, or docker_watcher)。