neondatabase/mcp-server-neon

Neon MCP Server – Neon Postgres への自然言語ブリッジ

概要

• 大規模言語モデル（LLM）と Neon serverless Postgres プラットフォームの間に位置するオープンソースの MCP（Model Context Protocol）サーバー。
• LLM 対応クライアント（Claude Code、Cursor、VS Code、Kiro など）から 自然言語 リクエストを受け取り、Neon API 呼び出しに変換して結果を返します。

重要性

• 非技術ユーザーが SQL を書いたり Neon の REST エンドポイントを覚えたりすることなく、データベースを管理（プロジェクト/ブランチの作成、クエリの実行、マイグレーションの適用）できるようにします。
• LLM と外部サービス間でコンテキスト（認証、意図、パラメータ）を安全に渡すための標準である Model Context Protocol の具体的なユースケースを示します。

主な機能

機能	仕組み	コマンド例
プロジェクトとブランチのライフサイクル	Neon Management API を呼び出します（create_project、list_branches、delete_branch など）	「my-database という新しい Postgres データベースを作成し、users テーブルを追加してください。」
スキーマ検査とマイグレーション	Neon スキーマツールを使用します（describe_table_schema、prepare_database_migration、complete_database_migration）	「users テーブルに created_at 列を追加してください。」
クエリ実行	ブランチのコンピュートエンドポイントに対して run_sql（読み取り専用）または run_sql_transaction（書き込み）を実行します	「users の最初の 10 行を表示してください。」
可観測性とドキュメント	list_slow_queries、inspect_database、search などの読み取り専用ツールを公開し、ドキュメント/リソースを提供します	「すべての Neon プロジェクトの概要を教えてください。」

使用方法

1. クイックセットアップ – npx neon@latest init を実行します。スクリプトが API キーを作成し、MCP サーバーをエディタに登録し、OAuth 同意画面を開きます。
2. リモートホストサーバー – パブリック MCP エンドポイント（https://mcp.neon.tech/mcp）をクライアントの mcp.json に追加します（またはワンクリック Kiro ボタンを使用）。認証は OAuth（推奨）または API キーヘッダーを使用できます。
3. 細かいアクセス制御 – URL クエリパラメータで LLM が実行できる操作を制御します：
   • readonly=true – 読み取り専用ツールのみが公開されます。
   • category=… – 特定のツールグループに制限します（例：querying と schema）。
   • projectId=… – すべての操作を単一の Neon プロジェクトにロックします。

セキュリティ上の注意

• サーバーは強力な操作（プロジェクトの作成/削除、マイグレーションの実行）を実行できます。サーバーが実行する前に、常に LLM が生成したプランをレビュー してください。
• ローカル開発 / IDE 統合 を目的としています。ドキュメントでは本番環境での使用を推奨していません。
• Neon アカウントが IP 許可リストを使用している場合は、静的 IP 34.192.103.46 と 23.22.233.166 を追加してください。

アーキテクチャの概要

• Vercel に Next.js App Router アプリとしてデプロイされています（mcp.neon.tech）。
• コアフォルダ：
  • app/api/[transport]/route.ts – 2 つのトランスポートモード（Streamable HTTP デフォルト と非推奨の SSE）を処理します。
  • app/api/authorize/* – OAuth フロー（検出、トークン、失効）。
  • mcp/ – すべての「ツール」の定義、リクエストハンドラ、分析、Sentry 統合。
  • lib/ – OAuth、設定、エラー処理のためのヘルパー。

詳細情報

• 公式ドキュメント：https://neon.com/docs/ai/neon-mcp-server
• 特定のエディタ/エージェント（Cursor、Claude Code、Cline、Windsurf、Zed など）向けのガイドは README にリンクされています。

結論 Neon MCP Server は、LLM を利用したアシスタントが自然言語で serverless Postgres データベースを管理できるようにする、本番グレードのブリッジであり、開発者は Model Context Protocol を介して権限とスコープを細かく制御できます。