mcpField
M
my-pi

my-pi

ローカル
github.com/BoxBoxmari開発ツール33 週間前に更新
リポジトリ

my-pi について

my-piは、コーディングエージェント向けのローカル優先MCPランタイムで、制限付きファイル操作、AST/LSPナビゲーション、Gitツールを通じてコードベースにアクセスします。初期設定は読み取り専用で、書き込みと言語サーバープロセスの起動には明示的な有効化が必要です。

主な機能

  1. 01ワークスペースのファイルアクセスを制限
  2. 02コンテンツ指紋で書き込みを保護
  3. 03AST検索とLSPによるコードナビゲーション
  4. 04Gitの状態と差分を確認
  5. 05読み取り専用のセキュリティ設定

活用シーン

  1. 01権限を制御してコードベースを閲覧
  2. 02シンボルから定義や参照を検索
  3. 03診断情報とコード変更を確認
  4. 04信頼できるワークスペースで書き込みを有効化

MCP 対応

stdio MCPサーバーとして動作し、コーディングクライアントにファイルシステム、検索、AST/LSP、Gitのツールを提供します。ファイル変更と言語サーバープロセスの起動には明示的な許可が必要で、初期設定は読み取り専用です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "boxboxmari-my-pi": {
      "command": "npx",
      "args": [
        "-y",
        "@koonwang03/my-pi"
      ]
    }
  }
}
起動コマンドnpx -y @koonwang03/my-pi

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@koonwang03/my-pi0.1.0-alpha.2

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

my-pi

npm version npm downloads mcpservers.org に掲載 my-pi MCP サーバー – Glama の品質・メンテナンススコア CI ステータス ライセンス

my-pi は、エージェントに制限のないシェルを渡すことなく、実際のコードベースへの制御されたアクセスを必要とするコーディングエージェント向けの、ローカル優先の Model Context Protocol（MCP）ランタイムです。

制限付きのファイルシステム操作、コンテンツを事前条件とする書き込み、構造的な AST 検索、言語サーバーによるナビゲーション、Git のステータス／差分ツール、明示的なデフォルト読み取り専用のセキュリティモデルを、1 つの stdio MCP サーバーにまとめています。

my-pi を選ぶ理由

  • ローカル優先： ソースコードと詳細なワークスペースの状態はホスト上に保持されます。
  • デフォルトで読み取り専用： 変更操作と言語サーバープロセスの起動には、明示的な権限昇格が必要です。
  • より安全な書き込み： 無条件の上書きではなく、コンテンツフィンガープリントによって更新を保護できます。
  • コードを考慮したナビゲーション： Tree-Sitter AST 検索に加え、LSP のシンボル、定義、参照、ホバー、診断を利用できます。
  • Git を考慮したコンテキスト： 制限付きのステータスおよび差分機能を備え、制限のないコマンド実行機能は公開しません。
  • ホストに依存しない： Claude Code、Cursor、OpenCode など、MCP 対応のコーディング環境向けに設計されています。

インストールと実行

Node.js >=24.0.0 が必要です。

npm install -g @koonwang03/my-pi
my-pi-mcp --workspace /path/to/project

または、グローバルインストールせずに生成されたホスト設定を確認できます。

npx --yes --package @koonwang03/my-pi my-pi-mcp host-config cursor-local

サーバーは読み取り専用のセキュリティプロファイルで起動します。信頼できるワークスペースでのみ、書き込みと言語サーバープロセスを有効にしてください。

my-pi-mcp --workspace /path/to/project --security-profile trusted

--workspace または MY_PI_WORKSPACE_ROOT を指定せずに起動すると、安全側に倒して失敗します。現在のディレクトリを明示的に使用する場合に限り、--allow-cwd を指定してください。

MCP の主な機能

安定版アルファの機能として、4 つのグループにわたる 13 個のツールを提供します。

  • ファイルシステム： fs_read、fs_write、fs_patch、fs_stat
  • 検索／ワークスペース： search、workspace_info
  • AST／LSP： ast_search、lsp_status、lsp_symbols、lsp_navigate、lsp_diagnostics
  • Git： vcs_status、vcs_diff

構造的な AST 検索は TypeScript、JavaScript、Python、Rust、Go に対応しています。LSP 統合は、ホスト上で互換性のある言語サーバー実行ファイルを利用できる場合に、TypeScript、Python、Rust、Go に対応します。

ホスト設定の生成

my-pi-mcp host-config claude-code-local
my-pi-mcp host-config cursor-local
my-pi-mcp host-config opencode-current-local

セキュリティモデル

my-pi は、明示的なワークスペース権限と、読み取り前に適用する機密パスのポリシーを使用します。デフォルトプロファイルは意図的に制限的に設定されています。信頼モードは、変更操作と言語サーバープロセスを有効にするための明示的なオプトインです。

信頼モードを有効にする前に、セキュリティモデル全体を確認してください。

https://github.com/BoxBoxmari/my-pi/blob/main/docs/SECURITY_MODEL.md

プロジェクトのステータス

現在のリリースチャネル：アルファ。このパッケージは、リポジトリの「Production Next」で進行中の調整／評価機能が実験段階にある間、評価および管理されたローカル開発に使用することを想定しています。

リポジトリ、アーキテクチャ、ベンチマーク、リリースの根拠資料、貢献方法の詳細：

https://github.com/BoxBoxmari/my-pi

主な実行ファイルは my-pi-mcp です。ccr-mcp は互換性エイリアスとして引き続き提供されています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。