Pincer MCP

🚀 Pincer MCP 🦀

Pincer-MCPは、セキュリティが強化されたModel Context Protocol (MCP)ゲートウェイです。これにより、エージェント型AIシステムにおける「致命的なトリフェクタ」脆弱性を排除します。ステートレスな仲介者として機能することで、Pincerはエージェントがあなたの実際のAPIキーを決して見ることがないようにします。

🚀 クイックスタート

前提条件

• Node.js 18+
• macOS、Windows、またはネイティブキーチェーンサポートのあるLinux

インストール

オプション1: グローバルインストール (推奨)

npm install -g pincer-mcp
# これで 'pincer' コマンドがシステム全体で利用可能になります

オプション2: ローカル開発

git clone https://github.com/VouchlyAI/Pincer-MCP.git
cd Pincer-MCP
npm install
npm run build
npm link  # 'pincer' コマンドをローカルで利用可能にします

ボールトのセットアップ

# 1. ボールトを初期化 (OSキーチェーンにマスターキーを作成)
pincer init

# 2. 実際のAPIキーを保存 (暗号化されます)
pincer set gemini_api_key "AIzaSyDpxPq..."
pincer set openai_api_key "sk-proj-..."

# 3. エージェントを登録し、プロキシトークンを生成
pincer agent add openclaw
# 出力: 🎫 プロキシトークン: pxr_V1StGXR8_Z5jdHi6B-myT

# 4. 特定のツールに対してエージェントを承認
pincer agent authorize openclaw gemini_generate

マルチキーサポート

同じツールに複数のキーを保存し、異なるエージェントに割り当てることができます。

# 2つの異なるGemini APIキーを保存
pincer set gemini_api_key "AIzaSy_KEY_FOR_CLAWDBOT..." --label key1
pincer set gemini_api_key "AIzaSy_KEY_FOR_MYBOT..." --label key2

# 保存されているすべてのキーを表示
pincer list

# 各エージェントに特定のキーを割り当て
pincer agent add clawdbot
pincer agent authorize clawdbot gemini_generate --key key1

pincer agent add mybot  
pincer agent authorize mybot gemini_generate --key key2

# エージェントの権限を表示
pincer agent list

結果: clawdbot はkey1を使用し、mybot はkey2を使用します。これはレート制限やコスト追跡に最適です。

サーバーの起動

npm run dev

エージェントの設定

エージェントにプロキシトークン (実際のAPIキーではない) を渡します。

export PINCER_PROXY_TOKEN="pxr_V1StGXR8_Z5jdHi6B-myT"

✨ 主な機能

Pincer-MCPは、セキュリティが強化されたModel Context Protocol (MCP)ゲートウェイで、エージェント型AIシステムの脆弱性を排除します。具体的には、以下のような機能を提供します。

• プロキシトークンアーキテクチャ：エージェントが実際のAPIキーを見ることがないようにします。
• 複数のツールサポート：Google Gemini、OpenAI、Anthropic Claudeなどの様々なAPIに対応しています。
• GPGキー管理：GPGキーの生成、インポート、エクスポート、エージェントの承認などをサポートします。
• マルチキーサポート：同じツールに複数のキーを保存し、異なるエージェントに割り当てることができます。
• セキュリティとコンプライアンス：企業レベルのセキュリティを提供します。

📦 インストール

上述のクイックスタートセクションに記載されている通り、グローバルインストールまたはローカル開発用のインストール方法があります。

💻 使用例

基本的な使用法

エージェントがツールを呼び出す際のリクエスト例です。

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "gemini_generate",
    "arguments": {
      "prompt": "Hello world",
      "model": "gemini-2.0-flash"
    },
    "_meta": {
      "pincer_token": "pxr_V1StGXR8_Z5jdHi6B-myT"
    }
  }
}

高度な使用法

マルチキーサポートの使用例です。

# 2つの異なるGemini APIキーを保存
pincer set gemini_api_key "AIzaSy_KEY_FOR_CLAWDBOT..." --label key1
pincer set gemini_api_key "AIzaSy_KEY_FOR_MYBOT..." --label key2

# 各エージェントに特定のキーを割り当て
pincer agent add clawdbot
pincer agent authorize clawdbot gemini_generate --key key1

pincer agent add mybot  
pincer agent authorize mybot gemini_generate --key key2

📚 ドキュメント

• セットアップガイド - Pincer-MCPの使い始め方
• IDE統合 - VSCode、Claude Desktop、CursorなどとPincerを使用する方法
• OpenClaw統合 - OpenClawエージェントとPincerを統合する方法
• テストガイド - 包括的なテストスイートのドキュメント
• 機能リファレンス - 完全なAPIと機能のドキュメント
• セキュリティポリシー - 脆弱性報告とセキュリティのベストプラクティス
• CHANGELOG - バージョン履歴とリリースノート

🔧 技術詳細

2層ボールトシステム

第1層: マスターキー (OSキーチェーン)

• macOSキーチェーン、Windows資格情報マネージャー、またはGNOMEキーリングに保存されます。
• ファイルシステムに触れることはありません。
• 暗号化/復号化のためにのみアクセスされます。

第2層: 暗号化されたストア (SQLite)

• ~/.pincer/vault.db にあるデータベースです。
• 3つのテーブルがあります。
  • secrets: 実際のAPIキー (AES-256-GCMで暗号化されています)
  • proxy_tokens: プロキシトークン → エージェントIDのマッピング
  • agent_mappings: エージェントID → ツール承認

認証フロー

Request (_meta.pincer_token: pxr_xxx)
  ↓
Gatekeeper: リクエストボディからプロキシトークンを抽出
  ↓
Vault: pxr_xxx → エージェントID → ツール名 → 実際のAPIキーを解決
  ↓
Injector: リアルタイムで復号化し、実際のキーを注入
  ↓
Caller: 外部API呼び出しを実行
  ↓
Scrubber: メモリ内のキーをゼロで上書き
  ↓
Audit: 改ざん検知可能なチェーンにログを記録

🔐 セキュリティとコンプライアンス

Pincerは企業レベルのセキュリティを備えています。

• ハードウェアバックed暗号化：マスター暗号化キーはOSネイティブのキーチェーンから決して離れません。
• プロキシトークン分離：エージェントは一時的な pxr_ トークンのみを扱い、実際の資格情報には触れません。
• JIT復号化：シークレットはAPI呼び出しの間だけ復号化されます。
• ゼロフットプリントメモリ：機密データは使用後すぐにメモリから消去 (ゼロクリア) されます。
• 細かい承認制御：エージェントごと、ツールごとの厳格なアクセス制御ポリシーがあります。
• 改ざん検知可能な監査ログ：SHA-256チェーンハッシュを使用した追記専用のツール呼び出し履歴です。
• 強化された実行環境：すべての入力に対するスキーマ検証と保護された環境での実行が行われます。
• Stdio互換性：標準のModel Context Protocolトランスポートと完全に互換性があります。

🔍 監査ログ

すべてのツール呼び出しは ~/.pincer/audit.jsonl にUTCとローカルのタイムスタンプ、文字数、推定トークン使用量とともに記録されます。

{
  "agentId": "openclaw",
  "tool": "gemini_generate",
  "duration": 234,
  "status": "success",
  "input_chars": 156,
  "output_chars": 423,
  "estimated_input_tokens": 39,
  "estimated_output_tokens": 106,
  "timestamp_utc": "2026-02-05T08:32:00.000Z",
  "timestamp_local": "2/5/2026, 2:02:45 PM",
  "chainHash": "a1b2c3d4e5f6g7h8",
  "prevHash": "0000000000000000"
}

トークン推定：Pincerは4:1の文字対トークン比率 (平均で約4文字あたり1トークン) を使用してトークン使用量を自動的に推定します。これにより、すべてのAIプロバイダーにわたって一貫したコスト追跡が可能になり、プロバイダー固有のAPIに依存する必要がありません。

チェーンハッシュは改ざん検知に役立ち、いかなる変更もSHA-256チェーンを破壊します。

🧪 開発

# 依存関係のインストール
npm install

# テストの実行
npm test

# ウォッチモードで実行
npm run dev

# 本番用にビルド
npm run build

🤝 コントリビューション

コントリビューションは歓迎されます！ガイドラインについては CONTRIBUTING.md を参照してください。

📄 ライセンス

BSL 1.1 (ビジネスソースライセンス) — 詳細は LICENSE を参照してください。2028年4月1日にApache 2.0に変更されます。

• Model Context Protocol - AIツール統合の標準。
• keytar - セキュアなクロスプラットフォームキーチェーンアクセス。
• better-sqlite3 - 高性能なローカル永続化。

❤️ より安全なAIの未来のために構築されました。