Neon MCP Server

आधिकारिक

Interact with the Neon serverless Postgres platform

दस्तावेज़

Neon MCP सर्वर

Neon MCP सर्वर एक ओपन-सोर्स उपकरण है जो आपको अपने Neon Postgres डेटाबेस के साथ प्राकृतिक भाषा में बातचीत करने देता है।

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) एक मानकीकृत प्रोटोकॉल है जो बड़े भाषा मॉडलों (LLMs) और बाहरी प्रणालियों के बीच संदर्भ प्रबंधित करने के लिए डिज़ाइन किया गया है। यह रिपॉजिटरी Neon के लिए एक दूरस्थ MCP सर्वर प्रदान करती है।

Neon का MCP सर्वर प्राकृतिक भाषा अनुरोधों और Neon API के बीच एक सेतु का काम करता है। MCP पर निर्मित, यह आपके अनुरोधों को आवश्यक API कॉल में अनुवाद करता है, जिससे आप प्रोजेक्ट और शाखाएँ बनाने, क्वेरी चलाने और डेटाबेस माइग्रेशन करने जैसे कार्यों को सहजता से प्रबंधित कर सकते हैं।

Neon MCP सर्वर की कुछ प्रमुख विशेषताओं में शामिल हैं:

प्राकृतिक भाषा में बातचीत: सहज, संवादात्मक आदेशों का उपयोग करके Neon डेटाबेस प्रबंधित करें।
सरलीकृत डेटाबेस प्रबंधन: SQL लिखे या सीधे Neon API का उपयोग किए बिना जटिल कार्य करें।
गैर-डेवलपर्स के लिए सुलभता: विभिन्न तकनीकी पृष्ठभूमि वाले उपयोगकर्ताओं को Neon डेटाबेस के साथ बातचीत करने में सक्षम बनाएं।
डेटाबेस माइग्रेशन समर्थन: प्राकृतिक भाषा के माध्यम से शुरू किए गए डेटाबेस स्कीमा परिवर्तनों के लिए Neon की शाखाकरण क्षमताओं का लाभ उठाएं।

उदाहरण के लिए, Claude Code या किसी भी MCP क्लाइंट में, आप Neon के साथ चीजों को पूरा करने के लिए प्राकृतिक भाषा का उपयोग कर सकते हैं, जैसे:

Let's create a new Postgres database, and call it "my-database". Let's then create a table called users with the following columns: id, name, email, and password.
I want to run a migration on my project called "my-project" that alters the users table to add a new column called "created_at".
Can you give me a summary of all of my Neon projects and what data is in each one?

[!WARNING]
Neon MCP सर्वर सुरक्षा विचार
Neon MCP सर्वर प्राकृतिक भाषा अनुरोधों के माध्यम से शक्तिशाली डेटाबेस प्रबंधन क्षमताएँ प्रदान करता है। निष्पादन से पहले LLM द्वारा अनुरोधित कार्यों की हमेशा समीक्षा करें और अधिकृत करें। सुनिश्चित करें कि केवल अधिकृत उपयोगकर्ताओं और अनुप्रयोगों की ही Neon MCP सर्वर तक पहुँच हो।

Neon MCP सर्वर केवल स्थानीय विकास और IDE एकीकरण के लिए अभिप्रेत है। हम उत्पादन परिवेशों में Neon MCP सर्वर का उपयोग करने की अनुशंसा नहीं करते हैं। यह शक्तिशाली संचालन निष्पादित कर सकता है जिससे आकस्मिक या अनधिकृत परिवर्तन हो सकते हैं।

अधिक जानकारी के लिए, MCP सुरक्षा मार्गदर्शन → देखें।

Neon MCP सर्वर सेट अप करना

Neon MCP सर्वर सेट अप करने के लिए कुछ विकल्प हैं:

API कुंजी के साथ त्वरित सेटअप (Cursor, VS Code, और Claude Code): एक ही कमांड से Neon के MCP सर्वर, एजेंट कौशल, और VS Code एक्सटेंशन को स्वचालित रूप से कॉन्फ़िगर करने के लिए neonctl@latest init चलाएँ।
दूरस्थ MCP सर्वर (OAuth आधारित प्रमाणीकरण): प्रमाणीकरण के लिए OAuth का उपयोग करके Neon के प्रबंधित MCP सर्वर से कनेक्ट करें। यह विधि अधिक सुविधाजनक है क्योंकि यह API कुंजियों को प्रबंधित करने की आवश्यकता को समाप्त करती है। इसके अतिरिक्त, जैसे ही वे जारी होंगे, आपको स्वचालित रूप से नवीनतम सुविधाएँ और सुधार प्राप्त होंगे।
दूरस्थ MCP सर्वर (API कुंजी आधारित प्रमाणीकरण): प्रमाणीकरण के लिए API कुंजी का उपयोग करके Neon के प्रबंधित MCP सर्वर से कनेक्ट करें। यह विधि तब उपयोगी है जब आप किसी दूरस्थ एजेंट को Neon से कनेक्ट करना चाहते हैं जहाँ OAuth उपलब्ध नहीं है। इसके अतिरिक्त, जैसे ही वे जारी होंगे, आपको स्वचालित रूप से नवीनतम सुविधाएँ और सुधार प्राप्त होंगे।

पूर्वापेक्षाएँ

एक MCP क्लाइंट अनुप्रयोग।
एक Neon खाता।
Node.js (>= v18.0.0): nodejs.org से डाउनलोड करें।

विकास के लिए, आपको Node.js 22+ की आवश्यकता होगी (pnpm Corepack के माध्यम से प्रदान किया जाता है — इसे सक्रिय करने के लिए corepack enable चलाएँ)।

विकल्प 1. API कुंजी के साथ त्वरित सेटअप

मैन्युअल रूप से API कुंजी नहीं बनाना चाहते?

एक ही कमांड से Neon के MCP सर्वर को स्वचालित रूप से कॉन्फ़िगर करने के लिए neonctl@latest init चलाएँ:

npx neonctl@latest init

यह Cursor, VS Code (GitHub Copilot), और Claude Code के साथ काम करता है। यह OAuth के माध्यम से प्रमाणित करेगा, आपके लिए एक Neon API कुंजी बनाएगा, और आपके संपादक को स्वचालित रूप से कॉन्फ़िगर करेगा।

विकल्प 2. दूरस्थ होस्टेड MCP सर्वर (OAuth आधारित प्रमाणीकरण)

प्रमाणीकरण के लिए OAuth का उपयोग करके Neon के प्रबंधित MCP सर्वर से कनेक्ट करें। यह सबसे आसान सेटअप है, इस सर्वर की किसी स्थानीय स्थापना की आवश्यकता नहीं है, और क्लाइंट में Neon API कुंजी कॉन्फ़िगर करने की आवश्यकता नहीं है।

अपने कार्यक्षेत्र में सभी पहचाने गए एजेंटों और संपादकों के लिए Neon MCP सर्वर जोड़ने हेतु निम्नलिखित कमांड चलाएँ:

npx add-mcp https://mcp.neon.tech/mcp

प्रोजेक्ट-स्कोप्ड के बजाय वैश्विक MCP सर्वर सूची में Neon MCP सर्वर जोड़ने के लिए -g फ़्लैग जोड़ें।

वैकल्पिक रूप से, आप अपने क्लाइंट की MCP सर्वर कॉन्फ़िगरेशन फ़ाइल (जैसे, mcp.json, mcp_config.json) में निम्नलिखित "Neon" प्रविष्टि जोड़ सकते हैं:

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

Kiro: अपनी Kiro MCP कॉन्फ़िग फ़ाइल (वैश्विक के लिए ~/.kiro/settings/mcp.json, या प्रोजेक्ट-स्कोप्ड के लिए .kiro/settings/mcp.json) में निम्नलिखित जोड़ें:

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp"
    }
  }
}

या इस README के शीर्ष पर एक-क्लिक इंस्टॉल बटन का उपयोग करें। अधिक जानकारी के लिए, Kiro MCP दस्तावेज़ीकरण देखें।

अपने MCP क्लाइंट को पुनरारंभ या ताज़ा करें।
आपके ब्राउज़र में एक OAuth विंडो खुलेगी। अपने MCP क्लाइंट को आपके Neon खाते तक पहुँचने के लिए अधिकृत करने हेतु संकेतों का पालन करें।

OAuth-आधारित प्रमाणीकरण के साथ, MCP सर्वर डिफ़ॉल्ट रूप से आपके व्यक्तिगत Neon खाते के अंतर्गत परियोजनाओं पर काम करेगा। किसी संगठन से संबंधित परियोजनाओं तक पहुँचने या प्रबंधित करने के लिए, आपको MCP क्लाइंट को अपने संकेत में स्पष्ट रूप से या तो org_id या project_id प्रदान करना होगा।

विकल्प 3. दूरस्थ होस्टेड MCP सर्वर (API कुंजी आधारित प्रमाणीकरण)

दूरस्थ MCP सर्वर Authorization हेडर में API कुंजी का उपयोग करके प्रमाणीकरण का भी समर्थन करता है यदि आपका क्लाइंट इसका समर्थन करता है।

Neon कंसोल में एक Neon API कुंजी बनाएँ। इसके बाद, अपने कार्यक्षेत्र में सभी पहचाने गए एजेंटों और संपादकों के लिए Neon MCP सर्वर जोड़ने हेतु निम्नलिखित कमांड चलाएँ:

npx add-mcp https://mcp.neon.tech/mcp --header "Authorization: Bearer <$NEON_API_KEY>"

{
  "mcpServers": {
    "Neon": {
      "type": "http",
      "url": "https://mcp.neon.tech/mcp",
      "headers": {
        "Authorization": "Bearer <$NEON_API_KEY>"
      }
    }
  }
}

केवल संगठन के अंतर्गत परियोजनाओं तक पहुँच सीमित करने के लिए किसी संगठन की API कुंजी प्रदान करें।

स्कोप और केवल-पढ़ने का मोड

Neon MCP OAuth स्कोप read, write, और * (* का अर्थ दोनों है) का समर्थन करता है। आपका MCP क्लाइंट सीधे इन स्कोप का अनुरोध कर सकता है, या आप OAuth अनुमतियाँ UI में चयन कर सकते हैं।

केवल-पढ़ने का मोड प्रतिबंधित करता है कि कौन से उपकरण उपलब्ध हैं, प्रोजेक्ट बनाने, शाखाएँ बनाने, या माइग्रेशन चलाने जैसे लेखन संचालन को अक्षम करता है। केवल-पढ़ने के उपकरणों में प्रोजेक्ट सूचीबद्ध करना, स्कीमा का वर्णन करना, डेटा क्वेरी करना और प्रदर्शन मीट्रिक देखना शामिल है।

आप केवल-पढ़ने का मोड दो तरीकों से सेट कर सकते हैं:

OAuth स्कोप चयन (अनुशंसित): OAuth में, प्राधिकरण UI में पूर्ण पहुँच को अनचेक करके केवल-पढ़ने का चयन करें।
readonly क्वेरी पैराम: अपने MCP सर्वर URL में ?readonly=true जोड़ें:

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp?readonly=true"
    }
  }
}

क्वेरी पैराम कैसे व्यवहार करता है:

API कुंजी प्रवाह: readonly=true केवल-पढ़ने का मोड सक्षम करने का तरीका है (इस प्रवाह में कोई OAuth स्कोप आदान-प्रदान नहीं है)।
OAuth प्रवाह: readonly=true OAuth स्कोप को ओवरराइड करता है। इसके बिना, केवल-पढ़ना OAuth सहमति UI में चयनित स्कोप द्वारा निर्धारित होता है।

लीगेसी HTTP हेडर x-read-only भी फ़ॉलबैक के रूप में समर्थित है (क्वेरी पैराम से कम प्राथमिकता)।

नोट: केवल-पढ़ने का मोड प्रतिबंधित करता है कि कौन से उपकरण उपलब्ध हैं। इसके अलावा, run_sql उपकरण केवल केवल-पढ़ने की क्वेरीज़ के लिए उपलब्ध रहता है।

अभिगम नियंत्रण के लिए URL क्वेरी पैराम

अनुदान संदर्भ (स्कोप श्रेणियाँ, प्रोजेक्ट स्कोपिंग, केवल-पढ़ने का मोड) MCP सर्वर URL पर URL क्वेरी पैराम के माध्यम से कॉन्फ़िगर किया जाता है। कॉन्फ़िगरेशन हर अनुरोध के साथ यात्रा करता है और तुरंत प्रभावी होता है — पुनः प्रमाणीकरण की आवश्यकता नहीं।

पैराम	विवरण	उदाहरण
`readonly`	केवल-पढ़ने का मोड सक्षम करें (`true`/`false`)	`?readonly=true`
`category`	विशिष्ट उपकरण श्रेणियों तक सीमित करें (दोहराया या CSV)	`?category=querying&category=schema`
`projectId`	सभी संचालन को एक ही प्रोजेक्ट तक सीमित करें	`?projectId=proj-123`

केवल-पढ़ने + प्रोजेक्ट-स्कोप्ड उदाहरण:

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp?readonly=true&projectId=my-project-id"
    }
  }
}

श्रेणी-फ़िल्टर्ड उदाहरण (केवल क्वेरींग और स्कीमा उपकरण):

{
  "mcpServers": {
    "Neon": {
      "url": "https://mcp.neon.tech/mcp?category=querying&category=schema"
    }
  }
}

आप /api/list-tools एंडपॉइंट का उपयोग करके किसी भी कॉन्फ़िगरेशन के लिए दृश्यमान उपकरणों का पूर्वावलोकन कर सकते हैं (कोई प्रमाणीकरण आवश्यक नहीं):

curl "https://mcp.neon.tech/api/list-tools?readonly=true&category=querying"

केवल-पढ़ने के मोड में उपलब्ध उपकरण

list_projects, list_shared_projects, describe_project, list_organizations
describe_branch, list_branch_computes, compare_database_schema
run_sql, run_sql_transaction, get_database_tables, describe_table_schema
list_slow_queries, explain_sql_statement
get_connection_string
search, fetch, list_docs_resources, get_doc_resource

लेखन पहुँच की आवश्यकता वाले उपकरण:

create_project, delete_project
create_branch, delete_branch, reset_from_parent
provision_neon_auth, provision_neon_data_api
prepare_database_migration, complete_database_migration
prepare_query_tuning, complete_query_tuning

सर्वर-प्रेषित ईवेंट (SSE) ट्रांसपोर्ट (पदावनत)

MCP दो दूरस्थ सर्वर ट्रांसपोर्ट का समर्थन करता है: पदावनत सर्वर-प्रेषित ईवेंट (SSE) और नया, अनुशंसित स्ट्रीमेबल HTTP। यदि आपका LLM क्लाइंट अभी तक स्ट्रीमेबल HTTP का समर्थन नहीं करता है, तो आप SSE का उपयोग करने के लिए एंडपॉइंट को https://mcp.neon.tech/mcp से https://mcp.neon.tech/sse में बदल सकते हैं।

SSE ट्रांसपोर्ट का उपयोग करके अपने कार्यक्षेत्र में सभी पहचाने गए एजेंटों और संपादकों के लिए Neon MCP सर्वर जोड़ने हेतु निम्नलिखित कमांड चलाएँ:

npx add-mcp https://mcp.neon.tech/sse --type sse

दूरस्थ सर्वर आर्किटेक्चर

दूरस्थ सर्वर Vercel पर mcp.neon.tech पर Next.js ऐप राउटर अनुप्रयोग के रूप में चलता है।

[!NOTE] मूल / पथ Neon MCP सर्वर दस्तावेज़ पर रीडायरेक्ट करता है। कोई लैंडिंग पृष्ठ नहीं है।

मुख्य कार्यान्वयन क्षेत्र:

landing/app/api/[transport]/route.ts: स्ट्रीमेबल HTTP (/mcp) और SSE (/sse) के लिए MCP ट्रांसपोर्ट एंडपॉइंट
landing/app/api/authorize/, landing/app/callback/, landing/app/api/token/, landing/app/api/revoke/: OAuth प्रवाह एंडपॉइंट
landing/app/.well-known/: OAuth खोज मेटाडेटा एंडपॉइंट
landing/mcp-src/: MCP सर्वर, उपकरण, हैंडलर, विश्लेषिकी, और Sentry एकीकरण
landing/lib/: Next.js-संगत सहायक (OAuth, कॉन्फ़िगरेशन, त्रुटि प्रबंधन)
landing/mcp-src/utils/read-only.ts: केवल-पढ़ने का मोड और स्कोप प्रबंधन

मार्गदर्शिकाएँ

विशेषताएँ

समर्थित उपकरण

Neon MCP सर्वर निम्नलिखित क्रियाएँ प्रदान करता है, जो MCP क्लाइंट को "उपकरण" के रूप में उजागर की जाती हैं। आप प्राकृतिक भाषा आदेशों का उपयोग करके अपने Neon प्रोजेक्ट और डेटाबेस के साथ बातचीत करने के लिए इन उपकरणों का उपयोग कर सकते हैं।

उपकरण स्कोप मेटाडेटा

प्रत्येक उपकरण परिभाषा में अनुदान-आधारित उपकरण फ़िल्टरिंग और सहमति UX के लिए उपयोग की जाने वाली scope श्रेणी शामिल है। वर्तमान श्रेणियाँ हैं:

projects
branches
schema
querying
neon_auth
data_api
docs
null (बिना स्कोप श्रेणी के उपकरण)

नोट्स:

compare_database_schema को schema के अंतर्गत वर्गीकृत किया गया है।
provision_neon_data_api को data_api के अंतर्गत वर्गीकृत किया गया है (neon_auth से अलग)।
केवल-पढ़ने का प्रवर्तन अभी भी readOnlySafe और सर्वर-साइड केवल-पढ़ने के तर्क पर निर्भर करता है; scope श्रेणी मेटाडेटा है, कोई स्टैंडअलोन पढ़ने/लिखने का स्विच नहीं।
प्रोजेक्ट-स्कोप्ड मोड (?projectId=...) में, search और fetch उपलब्ध नहीं हैं।

प्रोजेक्ट प्रबंधन:

list_projects: आपके खाते में पहले 10 Neon प्रोजेक्ट को सूचीबद्ध करता है, प्रत्येक प्रोजेक्ट का सारांश प्रदान करता है। यदि आप कोई विशिष्ट प्रोजेक्ट नहीं ढूँढ पा रहे हैं, तो limit पैरामीटर को उच्च मान पास करके सीमा बढ़ाएँ।
list_shared_projects: वर्तमान उपयोगकर्ता के साथ साझा किए गए Neon प्रोजेक्ट को सूचीबद्ध करता है। खोज पैरामीटर और लौटाए गए प्रोजेक्ट की संख्या सीमित करने का समर्थन करता है (डिफ़ॉल्ट: 10)।
describe_project: किसी विशिष्ट Neon प्रोजेक्ट के बारे में विस्तृत जानकारी प्राप्त करता है, जिसमें उसकी ID, नाम और संबद्ध शाखाएँ और डेटाबेस शामिल हैं।
create_project: आपके Neon खाते में एक नया Neon प्रोजेक्ट बनाता है। एक प्रोजेक्ट शाखाओं, डेटाबेस, भूमिकाओं और कंप्यूट के लिए एक कंटेनर के रूप में कार्य करता है।
delete_project: किसी मौजूदा Neon प्रोजेक्ट और उसके सभी संबद्ध संसाधनों को हटाता है।
list_organizations: उन सभी संगठनों को सूचीबद्ध करता है जिन तक वर्तमान उपयोगकर्ता की पहुँच है। खोज पैरामीटर का उपयोग करके वैकल्पिक रूप से संगठन के नाम या ID द्वारा फ़िल्टर करें।

शाखा प्रबंधन:

create_branch: एक निर्दिष्ट Neon प्रोजेक्ट के भीतर एक नई शाखा बनाता है। विकास, परीक्षण या माइग्रेशन के लिए Neon की शाखाकरण सुविधा का लाभ उठाता है।
delete_branch: किसी Neon प्रोजेक्ट से मौजूदा शाखा हटाता है।
describe_branch: किसी विशिष्ट शाखा के बारे में विवरण प्राप्त करता है, जैसे उसका नाम, ID और जनक शाखा।
list_branch_computes: किसी प्रोजेक्ट या विशिष्ट शाखा के लिए कंप्यूट एंडपॉइंट सूचीबद्ध करता है, जिसमें कंप्यूट ID, प्रकार, आकार, अंतिम सक्रिय समय और ऑटोस्केलिंग जानकारी शामिल है।
compare_database_schema: चाइल्ड शाखा और उसके जनक के बीच स्कीमा अंतर दिखाता है
reset_from_parent: वर्तमान शाखा को उसके जनक की स्थिति पर रीसेट करता है, स्थानीय परिवर्तनों को त्यागता है। यदि शाखा के चिल्ड्रन हैं तो स्वचालित रूप से बैकअप के लिए संरक्षित करता है, या वैकल्पिक रूप से कस्टम नाम के साथ अनुरोध पर संरक्षित करता है।

SQL क्वेरी निष्पादन:

get_connection_string: आपका डेटाबेस कनेक्शन स्ट्रिंग लौटाता है।
run_sql: एक निर्दिष्ट Neon डेटाबेस के विरुद्ध एकल SQL क्वेरी निष्पादित करता है। पढ़ने और लिखने दोनों कार्यों का समर्थन करता है।
run_sql_transaction: एक Neon डेटाबेस के विरुद्ध एकल लेन-देन में SQL क्वेरीज़ की एक श्रृंखला निष्पादित करता है।
get_database_tables: एक निर्दिष्ट Neon डेटाबेस के भीतर सभी तालिकाओं को सूचीबद्ध करता है।
describe_table_schema: किसी विशिष्ट तालिका की स्कीमा परिभाषा पुनर्प्राप्त करता है, जिसमें कॉलम, डेटा प्रकार और बाधाओं का विवरण होता है।

डेटाबेस माइग्रेशन (स्कीमा परिवर्तन):

prepare_database_migration: डेटाबेस माइग्रेशन प्रक्रिया आरंभ करता है। महत्वपूर्ण रूप से, यह मुख्य शाखा को प्रभावित करने से पहले माइग्रेशन को सुरक्षित रूप से लागू करने और परीक्षण करने के लिए एक अस्थायी शाखा बनाता है।
complete_database_migration: एक तैयार डेटाबेस माइग्रेशन को मुख्य शाखा पर अंतिम रूप देता है और लागू करता है। यह क्रिया अस्थायी माइग्रेशन शाखा से परिवर्तनों को मर्ज करती है और अस्थायी संसाधनों को साफ करती है।

SQL क्वेरींग और अनुकूलन:

list_slow_queries: डेटाबेस में सबसे धीमी क्वेरीज़ ढूँढकर प्रदर्शन बाधाओं की पहचान करता है। pg_stat_statements एक्सटेंशन की आवश्यकता है।
explain_sql_statement: प्रदर्शन बाधाओं की पहचान करने में मदद करने के लिए SQL क्वेरीज़ के लिए विस्तृत निष्पादन योजनाएँ प्रदान करता है।
prepare_query_tuning: क्वेरी प्रदर्शन का विश्लेषण करता है और अनुक्रमणिका निर्माण जैसे अनुकूलन सुझाता है। इन अनुकूलनों का सुरक्षित परीक्षण करने के लिए एक अस्थायी शाखा बनाता है।
complete_query_tuning: मुख्य शाखा पर अनुकूलन लागू करके या उन्हें त्यागकर क्वेरी ट्यूनिंग को अंतिम रूप देता है। अस्थायी ट्यूनिंग शाखा को साफ करता है।

Neon Auth:

provision_neon_auth: एक Neon प्रोजेक्ट के लिए Neon Auth का प्रावधान करता है। यह डेवलपर्स को एक Auth प्रदाता के साथ एकीकरण बनाकर आसानी से प्रमाणीकरण अवसंरचना स्थापित करने की अनुमति देता है।

Neon Data API:

provision_neon_data_api: Neon Auth या बाहरी JWKS प्रदाताओं के माध्यम से वैकल्पिक JWT प्रमाणीकरण के साथ HTTP-आधारित डेटाबेस पहुँच के लिए Neon Data API का प्रावधान करता है।

खोज और खोज:

search: किसी क्वेरी से मेल खाने वाले संगठनों, प्रोजेक्ट और शाखाओं में खोज करता है। ID, शीर्षक और Neon कंसोल के सीधे लिंक लौटाता है।
fetch: ID (आमतौर पर खोज उपकरण से) का उपयोग करके किसी विशिष्ट संगठन, प्रोजेक्ट या शाखा के बारे में विस्तृत जानकारी प्राप्त करता है।

दस्तावेज़ीकरण और संसाधन:

list_docs_resources: https://neon.com/docs/llms.txt से अनुक्रमणिका प्राप्त करके सभी उपलब्ध Neon दस्तावेज़ीकरण पृष्ठों को सूचीबद्ध करता है। पृष्ठ URL और शीर्षक लौटाता है जिन्हें get_doc_resource उपकरण का उपयोग करके व्यक्तिगत रूप से प्राप्त किया जा सकता है।
get_doc_resource: मार्कडाउन सामग्री के रूप में एक विशिष्ट Neon दस्तावेज़ीकरण पृष्ठ प्राप्त करता है। उपलब्ध पृष्ठ स्लग खोजने के लिए पहले list_docs_resources उपकरण का उपयोग करें, फिर इस उपकरण को स्लग पास करें।

माइग्रेशन

माइग्रेशन समय के साथ आपके डेटाबेस स्कीमा में परिवर्तनों को प्रबंधित करने का एक तरीका है। Neon MCP सर्वर के साथ, LLM अलग-अलग "Start" (prepare_database_migration) और "Commit" (complete_database_migration) कमांड के साथ सुरक्षित रूप से माइग्रेशन करने के लिए सशक्त हैं।

"Start" कमांड एक माइग्रेशन स्वीकार करता है और इसे एक नई अस्थायी शाखा में चलाता है। लौटने पर, यह कमांड LLM को संकेत देता है कि उसे इस शाखा पर माइग्रेशन का परीक्षण करना चाहिए। LLM तब मूल शाखा पर माइग्रेशन लागू करने के लिए "Commit" कमांड चला सकता है।

विकास

यह प्रोजेक्ट पैकेज मैनेजर के रूप में pnpm का उपयोग करता है, जो Corepack के माध्यम से पिन किया गया है।

प्रोजेक्ट संरचना

MCP सर्वर कोड landing/ निर्देशिका में रहता है, जो Vercel पर mcp.neon.tech पर तैनात एक Next.js अनुप्रयोग है।

cd landing
corepack enable
pnpm install

स्थानीय विकास

# Start the Next.js dev server (for the remote MCP server)
pnpm run dev

लिंटिंग और प्रकार जाँच

pnpm run lint
pnpm run typecheck

पर्यावरण चर

दूरस्थ सर्वर रनटाइम के लिए आवश्यक:

चर	विवरण
`SERVER_HOST`	सर्वर URL (डिफ़ॉल्ट `VERCEL_URL`)
`UPSTREAM_OAUTH_HOST`	Neon OAuth प्रदाता URL
`CLIENT_ID`	OAuth क्लाइंट ID
`CLIENT_SECRET`	OAuth क्लाइंट सीक्रेट
`COOKIE_SECRET`	हस्ताक्षरित कुकीज़ के लिए सीक्रेट
`KV_URL`	Vercel KV (Upstash Redis) URL
`OAUTH_DATABASE_URL`	टोकन भंडारण के लिए Postgres URL

वैकल्पिक:

चर	विवरण
`LOG_LEVEL`	विंस्टन लॉग स्तर: `error`, `warn`, `info` (डिफ़ॉल्ट), `debug`, `verbose`, `silly`

परीक्षण पिरामिड

सभी परीक्षण landing/ से चलते हैं।

cd landing

# Unit tests
pnpm run test:unit

# Integration tests
pnpm run test:integration

# MCP protocol end-to-end tests (real MCP client/server tool calls)
pnpm run test:e2e:mcp

# Website end-to-end tests (Playwright; provisions/validates ephemeral DB first)
pnpm run test:e2e:web

# Full end-to-end suite
pnpm run test:e2e

# Full test pyramid (unit + integration + e2e; used in CI)
pnpm run test

परीक्षण रणनीति:

ट्रांसपोर्ट/प्रोटोकॉल और उपयोगकर्ता-दृश्य व्यवहार के लिए E2E को प्राथमिकता दें।
नियतात्मक उपकरण अनुबंधों और वर्कफ़्लो व्यवहार के लिए एकीकरण परीक्षणों का उपयोग करें।
शुद्ध तर्क और किनारे के मामलों के लिए इकाई परीक्षणों का उपयोग करें।
मर्ज-गेटिंग परीक्षणों में तृतीय-पक्ष अपटाइम पर निर्भर रहने से बचें; एकीकरण/इकाई स्तरों में बाहरी निर्भरताओं का मॉक करें।

तैनाती

Vercel रिपॉजिटरी शाखा कॉन्फ़िगरेशन से दूरस्थ सर्वर को स्वचालित रूप से तैनात करता है। पुल अनुरोधों के लिए पूर्वावलोकन वातावरण उपलब्ध हैं।