MCP Server

🚀 SnapBack MCP Server

AIによるコード分析とモデルコンテキストプロトコルを介したスナップショット管理を提供します。SnapBackのコードセキュリティ機能をClaude Desktop、Cursor、およびMCP互換のAIツールに直接統合できます。

🚀 クイックスタート

npm install -g @snapback/mcp-server
snapback-mcp

設定不要ですぐに使えます！

✨ 主な機能

🆓 無料版（アカウント不要）

• ✅ リスク分析：コード変更におけるシークレットや脆弱性を検出します。
• ✅ 依存関係チェック：package.jsonの変更を検証します。
• ✅ ローカル分析：基本的なシークレット検出とセキュリティスキャンを行います。
• ✅ オフラインモード：インターネット接続なしで動作します。
• ✅ Context7統合：ライブラリのドキュメントとコード検索ができます。

☁️ プロ版（APIキーが必要）

snapback.devから無料のAPIキーを取得すると、以下の機能が利用できます。

• 🔐 高度な機械学習分析：AIによるリスク検出を行います。
• 🔐 スナップショット管理：コードのスナップショットを作成し、復元できます。
• 🔐 クラウド同期：デバイス間でスナップショットにアクセスできます。
• 🔐 チーム共有：コードセキュリティに関するコラボレーションが可能です。

📦 インストール

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "snapback": {
      "command": "npx",
      "args": ["-y", "@snapback/mcp-server"]
    }
  }
}

APIキーを使用する場合（オプション）

{
  "mcpServers": {
    "snapback": {
      "command": "npx",
      "args": ["-y", "@snapback/mcp-server"],
      "env": {
        "SNAPBACK_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor / その他のMCPクライアント

# グローバルにインストール
npm install -g @snapback/mcp-server

# stdioトランスポートで実行
snapback-mcp

💻 使用例

基本的な使用法

snapback.analyze_risk

コードの変更を適用する前に、潜在的なセキュリティリスクを分析します。 使用するタイミング

• AIによって生成されたコードを受け入れる前
• 複雑な変更をレビューするとき
• 重要なファイル（認証、データベース、設定）に対して

例

// AIが認証を追加することを検出
// 変更を適用する前に呼び出します
snapback.analyze_risk({
  changes: [
    { added: true, value: "const API_KEY = 'sk_live_...';" }
  ]
})
// 返り値: ⚠️ HIGH RISK: Hardcoded secret detected

snapback.check_dependencies

package.jsonが変更されたときに、依存関係に関するリスクをチェックします。 例

snapback.check_dependencies({
  before: { "lodash": "^4.17.15" },
  after: { "lodash": "^4.17.21" }
})
// 返り値: ℹ️ Security update available

高度な使用法

snapback.create_snapshot（プロ版）

リスクのある変更を行う前にコードのスナップショットを作成します。

snapback.create_snapshot({
  reason: "Before major refactor",
  files: ["src/auth.ts", "src/db.ts"]
})
// 返り値: ✅ Snapshot created: snap_xyz123

snapback.list_snapshots（プロ版）

利用可能なすべてのスナップショットをリストします。

snapback.restore_snapshot（プロ版）

以前のスナップショットからコードを復元します。

Context7ツール

• ctx7.resolve-library-id：ライブラリのドキュメントを検索します。
• ctx7.get-library-docs：ライブラリのドキュメントと例を取得します。

📚 ドキュメント

環境変数

# オプション: プロ機能を使用するためのSnapBack APIキー
SNAPBACK_API_KEY=sk_...

# オプション: カスタムAPI URL
SNAPBACK_API_URL=https://api.snapback.dev

# オプション: 拡張ドキュメント用のContext7 APIキー
CONTEXT7_API_KEY=...

# オプション: ログレベル
LOG_LEVEL=info

オフラインモード

設定やAPIキーなしでも完全に動作します。

# 環境変数は不要です！
npx @snapback/mcp-server

オフラインで動作する機能

• リスク分析（基本）
• 依存関係チェック
• シークレット検出
• Context7ライブラリ検索（キャッシュ済み）

APIキーが必要な機能

• 高度な機械学習リスク分析
• スナップショットの作成/復元
• クラウド同期
• チーム機能

🔧 技術詳細

┌─────────────────┐
│   AI Tool       │  (Claude, Cursor, etc.)
│   (MCP Client)  │
└────────┬────────┘
         │ MCP Protocol
         │
┌────────▼─────────────────────────────────┐
│  SnapBack MCP Server                     │
│  ┌──────────────┐  ┌──────────────────┐ │
│  │ Free Tools   │  │  Pro Tools       │ │
│  │ - analyze    │  │  - snapshots     │ │
│  │ - check_deps │  │  - cloud sync    │ │
│  └──────────────┘  └──────────────────┘ │
└───────────┬──────────────────────────────┘
            │
        ┌───┴────┐
        │        │
   ┌────▼───┐ ┌─▼─────────┐
   │ Local  │ │ SnapBack  │
   │Analysis│ │    API    │
   └────────┘ └───────────┘

📚 開発

ローカルでの実行

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

pnpm install
pnpm build
pnpm start

テスト

# テストを実行
pnpm test

# APIキーなしでテスト（オフラインモード）
unset SNAPBACK_API_KEY
pnpm start

# APIキーを使用してテスト
export SNAPBACK_API_KEY=sk_test_...
pnpm start

ビルド

pnpm build

# 出力: dist/index.js (ESM)

📚 トラブルシューティング

サーバーが起動しない場合

1. Node.jsのバージョンを確認します: node -v（バージョン18以上が必要）
2. キャッシュをクリアします: rm -rf node_modules && npm install
3. パーミッションを確認します: chmod +x $(which snapback-mcp)

APIキーが機能しない場合

1. キーの形式を確認します: sk_live_... または sk_test_...
2. 環境変数を確認します: echo $SNAPBACK_API_KEY
3. 新しいキーを取得します: snapback.dev/settings/api

Claudeにツールが表示されない場合

1. Claude Desktopを完全に再起動します。
2. 設定ファイルの構文を確認します（JSONは有効でなければなりません）。
3. Claudeのコンソールログにエラーがないか確認します。

📚 セキュリティ

• すべてのシークレットは環境変数を介して扱われます。
• APIキーがない場合はSnapBackにデータは送信されません。
• ローカル分析はオフラインで実行されます。
• オープンソースであり、コードを自分で監査できます。

セキュリティの問題を報告するには、security@snapback.devまでお問い合わせください。

📚 リンク

• ドキュメント：docs.snapback.dev
• メインリポジトリ：Marcelle-Labs/snapback.dev
• 問題報告：github.com/snapback-dev/mcp-server/issues
• NPM：@snapback/mcp-server

📄 ライセンス

Apache-2.0 © SnapBack

📚 関連リンク

• snapback VS Code拡張機能
• @snapback/sdk - TypeScript SDK
• @snapback/contracts - 型定義