NINJAMCP

CryptoNinja のキャラクター設定・世界観を AI に提供する MCP（Model Context Protocol）サーバー です。

Claude Desktop / Claude Code などの MCP クライアントに接続すると、AI が CryptoNinja 全42キャラの公式設定や世界観を正確に参照しながら、二次創作の相談・ストーリー作成・設定確認などを手伝えるようになります。

提供ツール

ツール	説明
list_characters	全キャラクター一覧（クラン絞り込み対応：伊賀・甲賀・風魔・雑賀・天界・根の国）
get_character	名前（日本語/英語）または ID（#012 等）でキャラの完全な設定を取得
get_character_image	キャラの公式イラスト画像を取得（2D / 3D 切り替え可）
get_worldview	世界観（シーズン時系列・クラン相関・未確定設定メモなど）を取得
search_lore	キーワードで全設定テキストを横断全文検索

セットアップ

npm install
npm run build

MCP クライアントへの登録

Claude Code

claude mcp add NINJAMCP -- node /path/to/MCP/dist/index.js

Claude Desktop（claude_desktop_config.json）

設定ファイルの場所:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "NINJAMCP": {
      "command": "node",
      "args": ["/path/to/MCP/dist/index.js"]
    }
  }
}

追記後、Claude Desktop を再起動すると 🔌 アイコンにツールが表示されます。

OpenAI Codex CLI（~/.codex/config.toml）

[mcp_servers.ninjamcp]
command = "node"
args = ["/path/to/MCP/dist/index.js"]

または CLI から:

codex mcp add ninjamcp -- node /path/to/MCP/dist/index.js

その他の MCP クライアント（Cursor / Windsurf など）

stdio トランスポート対応のクライアントなら同じ形式で登録できます。コマンドは共通で node /path/to/MCP/dist/index.js です。

/path/to/MCP は、このリポジトリを clone した実際のパスに置き換えてください。事前に npm install && npm run build が必要です。

リモートサーバー版（Cloudflare Workers）

worker/ ディレクトリに、同じ5ツールを HTTP で公開するリモート MCP サーバー（Streamable HTTP・依存ライブラリなし）が入っています。デプロイすると claude.ai の Web / スマホアプリや、URL 指定に対応した MCP クライアントから接続できます。

デプロイ

cd worker
npm install
npx wrangler login   # 初回のみ（Cloudflareアカウントが必要・無料枠でOK）
npx wrangler deploy

デプロイ後の MCP エンドポイントは https://ninjamcp.<your-subdomain>.workers.dev/mcp です。

リモート版への接続

claude.ai（Web / スマホ）: 設定 → コネクタ → 「カスタムコネクタを追加」で上記 URL を登録。

Claude Code:

claude mcp add --transport http NINJAMCP https://ninjamcp.<your-subdomain>.workers.dev/mcp

Codex CLI（~/.codex/config.toml）:

[mcp_servers.ninjamcp]
url = "https://ninjamcp.<your-subdomain>.workers.dev/mcp"

開発

npm run dev   # tsx で src/index.ts を直接実行

データは data/characters.json（キャラ設定）と data/worldview.json（世界観）にあり、編集すれば再ビルドなしで反映されます。

データ出典

• 【保存版】CryptoNinja 世界観とキャラクター設定まとめ（だんく氏）

CryptoNinja は Ninja DAO / イケハヤ氏によるNFTプロジェクトです。二次創作・商用利用の範囲は公式ガイドラインを確認してください。