Skip to content

Takamasa045/nanobanana-rules

Repository files navigation

ナノバナナルール (nanobanana-rules)

Gemini API の画像生成に関するガイドラインをライブ取得して抜粋し、JSON で返す Model Context Protocol (MCP) サーバーです。

概要 / 特徴 / 注意

  • 特徴: ai.google.dev のドキュメントを都度取得し、要点を抽出してテンプレート付きで返します。
  • 抜粋: SynthID 言及や inlineData 仕様など、実装に重要なキーワードを自動検出します。
  • 出典URL: 返却 JSON にドキュメント URL を含めます。
  • 非公式: Google/ai.google.dev 非公式の補助ツールです。内容の正確性や最新性は保証しません。

セットアップ

  • 前提: Node.js 18 以上(このサーバーは Node.js 18+ で動作確認済み。package.jsonengines>=18.17 を指定済み)
  • 依存関係のインストール: npm i
  • ビルド: npm run build
  • 実行 (stdio): npm start

インストール手順(クローンから起動まで)

git clone https://github.com/Takamasa045/nanobanana-rules.git
cd nanobanana-rules
npm install
npm run build
npm start

Quick use(npx で即起動)

npx nanobanana-rules
# Claude Code での登録(PATH に入っていればそのまま呼べます)
claude mcp add nanobanana-rules --scope user -- nanobanana-rules

Claude Code 連携(ローカル実行の指定パスで)

claude mcp add nanobanana-rules --scope user -- node $PWD/dist/server.js

ツール例

get_rules { "lang": "ja", "model": "gemini-2.5-flash-image-preview" }

免責

  • 取得元は ai.google.dev。各種規約・robots.txt を遵守します。
  • 永続キャッシュは行いません(短時間のメモリキャッシュのみ・既定TTL約90秒)。
  • 注意: 本プロジェクトは Google 非公式の補助ツールです。取得するコンテンツは Google に帰属します。利用者は Google Generative AI 利用規約 を必ず順守してください。

サンプルレスポンス(短縮)

{
  "version": "2025-09-02",
  "references": {
    "image_generation_doc": "https://ai.google.dev/gemini-api/docs/image-generation?hl=ja"
  },
  "policies": {
    "content_rights_required": true,
    "synthid_watermark_expected": true
  },
  "modes_supported": ["text_to_image", "image_edit"]
}

MCP Inspector(動作確認)

npx @modelcontextprotocol/inspector nanobanana-rules
# またはローカルビルドしたファイルを指定
# npx @modelcontextprotocol/inspector node dist/server.js

npm 公開(任意)

npm login
npm run build
npm publish --access public

公開後の利用:

npx nanobanana-rules
claude mcp add nanobanana-rules --scope user -- nanobanana-rules

プロジェクト構成

  • src/server.ts: MCP サーバー本体
  • dist/: ビルド成果物(git 追跡対象外)

ライセンス

MIT License を参照してください。

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published