ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ติดตั้งในเครื่อง
- บัญชีหรือคีย์ ต้องมี GRAPHQL_TOKEN
- หมวด เครื่องมือนักพัฒนา
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Bridges any GraphQL API to Claude Code — auto-generates MCP tools via schema introspection.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
andrej-karpathy-skills
andrej-karpathy-skills เป็นไฟล์ CLAUDE.md ไฟล์เดียวที่ใช้ปรับพฤติกรรมของ Claude Code ให้ดีขึ้น โดยอ้างอิงจากข้อสังเกตของ Andrej Karpathy เกี่ยวกับข้อผิดพลาดที่พบบ่อยเมื่อ LLM เขียนโค้ด
ทำไมอยู่อันดับนี้
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 4/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 0/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 16/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง MCP Graphql Bridge ให้หน่อย ทำตาม https://mcp.popnx.com/i/murilojrpereira-mcp-graphql-bridge.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ · ✓ ตรวจคำสั่งแล้ว 14 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Claude AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ MCP Graphql Bridge ให้ Claude ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "graphql-bridge": { "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง GRAPHQL_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Graphql Bridge ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง Node.js ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
node -v- ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
node -vลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js
สมัครและสร้างคีย์ของ MCP Graphql Bridge
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
เปิดไฟล์ตั้งค่าของแอป Claude บนคอม
SettingsDeveloperEdit Config
วางค่าตั้งนี้แล้วบันทึกไฟล์
{ "mcpServers": { "graphql-bridge": { "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "ใส่ค่าของคุณ" } } } }วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
ปิดแอป Claude แล้วเปิดใหม่
ลองเลย
ใช้ MCP Graphql Bridge บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ MCP Graphql Bridge หรือมีชื่อเครื่องมือของ MCP Graphql Bridge ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
GRAPHQL_API_URLURL ของ endpoint GraphQL ที่ใช้รันคิวรีและ mutation ค่าเริ่มต้นคือ Countries API สาธารณะดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.GRAPHQL_INTROSPECTION_URLURL ของ endpoint GraphQL ที่ใช้สำหรับ schema introspection ค่าเริ่มต้นคือ GRAPHQL_API_URLดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.GRAPHQL_INTROSPECTION_TOKENโทเคน Bearer สำหรับการตรวจสอบ schema ค่าเริ่มต้นคือ GRAPHQL_TOKENดูต้นฉบับภาษาอังกฤษ
Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN.GRAPHQL_MAX_TOOLSจำนวนเครื่องมือการค้นหาและการเปลี่ยนแปลงข้อมูลที่สร้างขึ้นโดยอัตโนมัติสูงสุด ค่าเริ่มต้นคือ 128ดูต้นฉบับภาษาอังกฤษ
Maximum number of generated query and mutation tools. Defaults to 128.GRAPHQL_INCLUDE_MUTATIONSตั้งเป็น false เพื่อปิดเครื่องมือการเปลี่ยนแปลงและการดำเนินการเปลี่ยนแปลง ค่าเริ่มต้นคือ trueดูต้นฉบับภาษาอังกฤษ
Set to false to disable mutation tools and mutation execution. Defaults to true.GRAPHQL_MAX_RETRIESลองใหม่สำหรับการตอบกลับชั่วคราวจากระบบปลายทาง ค่าเริ่มต้นคือ 0ดูต้นฉบับภาษาอังกฤษ
Retries for transient upstream responses. Defaults to 0.
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ChatGPT ยังต่อ MCP Graphql Bridge ไม่ได้
MCP Graphql Bridge ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ MCP Graphql Bridge ได้
- ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว) · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
- ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
- ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
- ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
ข · ตัวอื่นในหมวด เครื่องมือนักพัฒนา ที่ต่อกับ ChatGPT ได้
เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์
- Sentry✓ ChatGPT
- Compiler Explorer✓ ChatGPT
- GitDiagram✓ ChatGPT
ต่อกับ Claude Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Claude Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ MCP Graphql Bridge ให้ Claude Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): claude mcp add --scope user graphql-bridge --env GRAPHQL_TOKEN='ใส่ค่าของคุณ' -- npx -y mcp-graphql-bridge 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง GRAPHQL_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Graphql Bridge ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง Node.js ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
node -v- ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
node -vลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js
สมัครและสร้างคีย์ของ MCP Graphql Bridge
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
เปิด Terminal
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
วางคำสั่งนี้แล้วกด Enter
claude mcp add --scope user graphql-bridge --env GRAPHQL_TOKEN='ใส่ค่าของคุณ' -- npx -y mcp-graphql-bridgeแก้ “ใส่ค่าของคุณ” เป็นคีย์ของคุณก่อนกด Enter
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
พิมพ์ /mcp ใน Claude Code
ต้องเห็น MCP Graphql Bridge ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ลองเลย
ใช้ MCP Graphql Bridge บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ MCP Graphql Bridge หรือมีชื่อเครื่องมือของ MCP Graphql Bridge ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
GRAPHQL_API_URLURL ของ endpoint GraphQL ที่ใช้รันคิวรีและ mutation ค่าเริ่มต้นคือ Countries API สาธารณะดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.GRAPHQL_INTROSPECTION_URLURL ของ endpoint GraphQL ที่ใช้สำหรับ schema introspection ค่าเริ่มต้นคือ GRAPHQL_API_URLดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.GRAPHQL_INTROSPECTION_TOKENโทเคน Bearer สำหรับการตรวจสอบ schema ค่าเริ่มต้นคือ GRAPHQL_TOKENดูต้นฉบับภาษาอังกฤษ
Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN.GRAPHQL_MAX_TOOLSจำนวนเครื่องมือการค้นหาและการเปลี่ยนแปลงข้อมูลที่สร้างขึ้นโดยอัตโนมัติสูงสุด ค่าเริ่มต้นคือ 128ดูต้นฉบับภาษาอังกฤษ
Maximum number of generated query and mutation tools. Defaults to 128.GRAPHQL_INCLUDE_MUTATIONSตั้งเป็น false เพื่อปิดเครื่องมือการเปลี่ยนแปลงและการดำเนินการเปลี่ยนแปลง ค่าเริ่มต้นคือ trueดูต้นฉบับภาษาอังกฤษ
Set to false to disable mutation tools and mutation execution. Defaults to true.GRAPHQL_MAX_RETRIESลองใหม่สำหรับการตอบกลับชั่วคราวจากระบบปลายทาง ค่าเริ่มต้นคือ 0ดูต้นฉบับภาษาอังกฤษ
Retries for transient upstream responses. Defaults to 0.
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ Cursor AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ MCP Graphql Bridge ให้ Cursor ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "mcpServers": { "graphql-bridge": { "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง GRAPHQL_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Graphql Bridge ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง Node.js ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
node -v- ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
node -vลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js
สมัครและสร้างคีย์ของ MCP Graphql Bridge
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ MCP Graphql Bridge ช่อง GRAPHQL_TOKEN ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน Cursor โหมด Agent
ลองเลย
ใช้ MCP Graphql Bridge บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ MCP Graphql Bridge หรือมีชื่อเครื่องมือของ MCP Graphql Bridge ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
GRAPHQL_API_URLURL ของ endpoint GraphQL ที่ใช้รันคิวรีและ mutation ค่าเริ่มต้นคือ Countries API สาธารณะดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.GRAPHQL_INTROSPECTION_URLURL ของ endpoint GraphQL ที่ใช้สำหรับ schema introspection ค่าเริ่มต้นคือ GRAPHQL_API_URLดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.GRAPHQL_INTROSPECTION_TOKENโทเคน Bearer สำหรับการตรวจสอบ schema ค่าเริ่มต้นคือ GRAPHQL_TOKENดูต้นฉบับภาษาอังกฤษ
Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN.GRAPHQL_MAX_TOOLSจำนวนเครื่องมือการค้นหาและการเปลี่ยนแปลงข้อมูลที่สร้างขึ้นโดยอัตโนมัติสูงสุด ค่าเริ่มต้นคือ 128ดูต้นฉบับภาษาอังกฤษ
Maximum number of generated query and mutation tools. Defaults to 128.GRAPHQL_INCLUDE_MUTATIONSตั้งเป็น false เพื่อปิดเครื่องมือการเปลี่ยนแปลงและการดำเนินการเปลี่ยนแปลง ค่าเริ่มต้นคือ trueดูต้นฉบับภาษาอังกฤษ
Set to false to disable mutation tools and mutation execution. Defaults to true.GRAPHQL_MAX_RETRIESลองใหม่สำหรับการตอบกลับชั่วคราวจากระบบปลายทาง ค่าเริ่มต้นคือ 0ดูต้นฉบับภาษาอังกฤษ
Retries for transient upstream responses. Defaults to 0.
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ แต่ต้องเตรียมก่อน
ต้องมีคีย์ของ MCP Graphql Bridge (สร้างที่เว็บของผู้ทำ) · ต้องลง Node.js ในเครื่องก่อน (ทำครั้งเดียว)
ให้ AI ติดตั้งให้
คัดลอกข้อความนี้ไปวางในแชตของ VS Code AI จะเช็กเครื่อง บอกว่าจะแก้ไฟล์ไหน และรอคุณตกลงก่อนทุกครั้ง
ช่วยติดตั้ง MCP server ชื่อ MCP Graphql Bridge ให้ VS Code ในเครื่องนี้ ทำตามลำดับ 1) เช็กว่ามี Node.js ด้วยคำสั่ง node -v ถ้าไม่มี ให้บอกฉันไปลงจาก https://nodejs.org/en/download ห้ามลงเอง 2) ใช้คอนฟิกนี้เท่านั้น (ผ่านตัวตรวจของ PopNx MCP แล้ว): { "servers": { "graphql-bridge": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-graphql-bridge" ], "env": { "GRAPHQL_TOKEN": "ใส่ค่าของคุณ" } } } } 3) บอก path เต็มของไฟล์ที่จะแก้ หรือคำสั่งที่จะรัน แล้วรอฉันตกลงก่อน 4) ช่อง GRAPHQL_TOKEN ให้คงคำว่า "ใส่ค่าของคุณ" ไว้ก่อน แล้วบอกให้ฉันวางค่าจริงเองในไฟล์หรือช่องของแอป ห้ามขอให้ฉันพิมพ์คีย์ในแชต 5) ทำตามที่ตกลง แล้วตรวจว่าเครื่องมือของ MCP Graphql Bridge ขึ้นจริงข้อความนี้ไม่มีคีย์ของคุณ ถ้าต้องใช้คีย์ AI จะบอกให้คุณวางเองในไฟล์หรือช่องของแอป
ลง Node.js ในเครื่อง (ถ้ายังไม่มี)
ลงไว้แล้วหรือยัง? เช็กก่อน · เปิด Terminal แล้วพิมพ์คำสั่งนี้ กด Enter
node -v- ขึ้นเลขรุ่น เช่น v26.13.1 = ลงแล้ว ข้ามขั้นนี้ได้
- ขึ้นว่า "command not found" (Windows ขึ้นว่า "is not recognized") = ยังไม่ได้ลง หรือเพิ่งลงแต่ยังไม่ได้ปิดแล้วเปิด Terminal ใหม่
เปิด Terminal ยังไง
Mac: กด ⌘ + Space พิมพ์ Terminal แล้วกด Enter
Windows: เปิดเมนู Start พิมพ์ Windows PowerShell แล้วกด Open
ยังไม่ได้ลง: เปิดหน้าดาวน์โหลดทางการ เลือกรุ่น LTS แล้วเลือกตัวติดตั้งแบบกดเอง: Mac ไฟล์ .pkg · Windows ไฟล์ .msi ดับเบิลคลิกแล้วกดถัดไปจนจบ ไม่ต้องใช้คำสั่ง curl
ลงเสร็จแล้ว ปิด Terminal เปิดใหม่ แล้วพิมพ์คำสั่งเดิมอีกครั้ง ต้องขึ้นเลขรุ่น:
node -vลงครั้งเดียว ใช้ได้กับทุกตัวที่ต้องใช้ Node.js
สมัครและสร้างคีย์ของ MCP Graphql Bridge
เปิดเว็บของผู้ทำ สมัครบัญชีแล้วสร้างคีย์ (API key) เก็บไว้ ใช้ในขั้นถัดไป ราคาและแผนฟรีดูที่เว็บของผู้ทำ
วิธีขอคีย์อยู่ใน README ของผู้ทำด้านล่าง
ใส่คีย์ในช่องที่ว่างไว้
ในค่าตั้งของ MCP Graphql Bridge ช่อง GRAPHQL_TOKEN ยังว่าง ใส่คีย์ของคุณแล้วบันทึก
วางคีย์ในช่องของแอปเท่านั้น อย่าวางในแชตหรือส่งให้ใคร
เปิดแชตของ AI ใน VS Code โหมด Agent
ลองเลย
ใช้ MCP Graphql Bridge บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ MCP Graphql Bridge หรือมีชื่อเครื่องมือของ MCP Graphql Bridge ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ค่าตั้งเพิ่มเติม 6 ช่อง (ไม่ต้องกรอกก็ใช้ได้)
คำสั่งด้านบนใช้ได้เลยโดยไม่ต้องใส่ค่าเหล่านี้ ถ้าอยากปรับค่อยเพิ่มเองตามคำอธิบายของผู้ทำ
GRAPHQL_API_URLURL ของ endpoint GraphQL ที่ใช้รันคิวรีและ mutation ค่าเริ่มต้นคือ Countries API สาธารณะดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.GRAPHQL_INTROSPECTION_URLURL ของ endpoint GraphQL ที่ใช้สำหรับ schema introspection ค่าเริ่มต้นคือ GRAPHQL_API_URLดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.GRAPHQL_INTROSPECTION_TOKENโทเคน Bearer สำหรับการตรวจสอบ schema ค่าเริ่มต้นคือ GRAPHQL_TOKENดูต้นฉบับภาษาอังกฤษ
Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN.GRAPHQL_MAX_TOOLSจำนวนเครื่องมือการค้นหาและการเปลี่ยนแปลงข้อมูลที่สร้างขึ้นโดยอัตโนมัติสูงสุด ค่าเริ่มต้นคือ 128ดูต้นฉบับภาษาอังกฤษ
Maximum number of generated query and mutation tools. Defaults to 128.GRAPHQL_INCLUDE_MUTATIONSตั้งเป็น false เพื่อปิดเครื่องมือการเปลี่ยนแปลงและการดำเนินการเปลี่ยนแปลง ค่าเริ่มต้นคือ trueดูต้นฉบับภาษาอังกฤษ
Set to false to disable mutation tools and mutation execution. Defaults to true.GRAPHQL_MAX_RETRIESลองใหม่สำหรับการตอบกลับชั่วคราวจากระบบปลายทาง ค่าเริ่มต้นคือ 0ดูต้นฉบับภาษาอังกฤษ
Retries for transient upstream responses. Defaults to 0.
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สำหรับคนเขียนโค้ด: คำสั่ง Terminal และค่าตั้ง JSON
ติดตั้งในเครื่อง
Claude Code
claude mcp add --scope user graphql-bridge --env GRAPHQL_TOKEN='ใส่ค่าของคุณ' -- npx -y mcp-graphql-bridgeClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"graphql-bridge": {
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"graphql-bridge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-graphql-bridge"
],
"env": {
"GRAPHQL_TOKEN": "ใส่ค่าของคุณ"
}
}
}
}ค่าที่ต้องใส่เอง
GRAPHQL_API_URLenvURL ของ endpoint GraphQL ที่ใช้รันคิวรีและ mutation ค่าเริ่มต้นคือ Countries API สาธารณะดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for executing queries and mutations. Defaults to the public Countries API.GRAPHQL_INTROSPECTION_URLenvURL ของ endpoint GraphQL ที่ใช้สำหรับ schema introspection ค่าเริ่มต้นคือ GRAPHQL_API_URLดูต้นฉบับภาษาอังกฤษ
GraphQL endpoint URL used for schema introspection. Defaults to GRAPHQL_API_URL.GRAPHQL_TOKENความลับ จำเป็น envโทเค็น Bearer สำหรับการยืนยันตัวตนเมื่อรันคิวรีและมิวเทชันดูต้นฉบับภาษาอังกฤษ
Bearer token for authenticating query and mutation execution.GRAPHQL_INTROSPECTION_TOKENความลับ envโทเคน Bearer สำหรับการตรวจสอบ schema ค่าเริ่มต้นคือ GRAPHQL_TOKENดูต้นฉบับภาษาอังกฤษ
Bearer token for schema introspection. Defaults to GRAPHQL_TOKEN.GRAPHQL_MAX_TOOLSenvจำนวนเครื่องมือการค้นหาและการเปลี่ยนแปลงข้อมูลที่สร้างขึ้นโดยอัตโนมัติสูงสุด ค่าเริ่มต้นคือ 128ดูต้นฉบับภาษาอังกฤษ
Maximum number of generated query and mutation tools. Defaults to 128.GRAPHQL_INCLUDE_MUTATIONSenvตั้งเป็น false เพื่อปิดเครื่องมือการเปลี่ยนแปลงและการดำเนินการเปลี่ยนแปลง ค่าเริ่มต้นคือ trueดูต้นฉบับภาษาอังกฤษ
Set to false to disable mutation tools and mutation execution. Defaults to true.GRAPHQL_MAX_RETRIESenvลองใหม่สำหรับการตอบกลับชั่วคราวจากระบบปลายทาง ค่าเริ่มต้นคือ 0ดูต้นฉบับภาษาอังกฤษ
Retries for transient upstream responses. Defaults to 0.
คำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
สรุป
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub murilojrpereira ซึ่งเป็นเจ้าของ repo
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด 3 วันที่ผ่านมา
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)
ไม่พบรายการใน OSV.dev สำหรับ mcp-graphql-bridge@2.1.0
ตรวจเฉพาะตัวแพ็กเกจรุ่นนี้ ไม่ใช่ทุก dependency · ตรวจเมื่อ 15 พ.ย. 2569
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/murilojrpereira-mcp-graphql-bridge)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เครื่องมือนักพัฒนาi
- ดาวมากกว่า 69% ของอีก 6103 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 23% ของอีก 6103 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 6103 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
MCP Graphql Bridge ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: GRAPHQL_TOKEN
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด 3 วันที่ผ่านมา และส่งรุ่นล่าสุด (2.1.0) เข้า registry 4 เดือนที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Node.js ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
ตัวอื่นที่ทำงานคล้ายกัน
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
GitDiagram
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Appllama
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP
Cloudflare MCP servers
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Repowise
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| ตัวนี้ MCP Graphql Bridge | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| ผลตรวจเบื้องต้น | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| สัญญาอนุญาต | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
mcp-graphql-bridge
A generic MCP (Model Context Protocol) server that bridges any GraphQL API to Claude Code. It introspects your GraphQL schema and exposes each query and mutation as an individual tool, letting Claude interact with your API directly.
How it works
On startup the server will:
- Look for a
schema-introspection.jsonfile in the working directory (fast, no network call) - If not found, run live introspection against
GRAPHQL_INTROSPECTION_URL - Register one tool per query (
query__) and one per mutation (mutation__) - Always register a generic
execute_graphqlfallback tool and aget_type_detailsexplorer tool
Requirements
- Node.js >= 20
Setup
Step 1: Install
Option A: Install from npm (recommended)
npm install -g mcp-graphql-bridge
Option B: Clone and build from source
git clone https://github.com/murilojrpereira/mcp-graphql-bridge.git
cd mcp-graphql-bridge npm install npm run build
Step 2: Configure environment variables
| Variable | Required | Description |
|---|---|---|
GRAPHQL_API_URL | No | Endpoint used for queries and mutations. Defaults to a public demo API (countries.trevorblades.com) if unset — replace with your own for real use. |
GRAPHQL_INTROSPECTION_URL | No | Endpoint used for schema introspection. Defaults to GRAPHQL_API_URL if unset. |
GRAPHQL_TOKEN | No | Bearer token for GraphQL authentication (used for query/mutation execution). Omit for public APIs. |
GRAPHQL_INTROSPECTION_TOKEN | No | Bearer token for schema introspection, if it requires different credentials than execution (e.g. a separate schema registry). Defaults to GRAPHQL_TOKEN if unset. |
MCP_AUTH_TOKEN | No | Bearer token required by the hosted /mcp HTTP endpoint when MCP_TRANSPORT=http |
GRAPHQL_MAX_TOOLS | No | Maximum number of query/mutation tools to register. Queries are prioritized over mutations when truncating. Default 128. |
GRAPHQL_INCLUDE_MUTATIONS | No | Set to false to exclude every mutation field entirely, for a read-only deployment. Default true. |
GRAPHQL_MAX_RETRIES | No | Retries (0–5) for 429/502/503/504 responses, honoring Retry-After when present. Default 0 (disabled). |
For schemas with hundreds of fields (GitHub's GraphQL API has 284 root fields — 32 queries, 252 mutations), GRAPHQL_MAX_TOOLS and GRAPHQL_INCLUDE_MUTATIONS are what keep registration bounded and predictable. If the cap truncates the schema, stderr logs exactly how many queries/mutations were registered vs. available.
No configuration is required to try the server — with nothing set, it starts against the public demo API above and logs that it's doing so. See docs/architecture.md for the full token model and why the GraphQL endpoint is fixed per deployment rather than a per-request parameter.
You can set these in a .env file at the project root:
GRAPHQL_API_URL=https://your-api.example.com/graphql
GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql GRAPHQL_TOKEN=your-bearer-token
Or pass them directly via the claude mcp add command (see below).
Step 3: (Optional) Pre-generate schema snapshot
By default the server introspects your schema live on startup — no file needed, and it automatically retries at a shallower query depth if your API rejects the full-depth attempt (some APIs, especially CDN-fronted ones, enforce a query depth limit). Use this step only if your API has introspection disabled entirely in production, or you want faster startup times:
curl -s -X POST https://your-api.example.com/graphql \
-H "Content-Type: application/json" \ -H "Authorization: Bearer your-bearer-token" \ -d '{"query":"{ __schema { queryType { fields { name description args { name description defaultValue type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } } mutationType { fields { name description args { name description defaultValue type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } } } }"}' \
schema-introspection.json
If your API rejects this with a depth/complexity-limit error, shrink the ofType { ... } nesting (each level resolves one more NonNull/List wrapper — most real-world types need 2-3 levels; only doubly-wrapped lists like [[Int!]!]! need more).
Adding to Claude Code
Option A: User scope (just for you)
If installed from npm:
claude mcp add --transport stdio \
--env GRAPHQL_API_URL=https://your-api.example.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql \ --env GRAPHQL_TOKEN=your-bearer-token \ graphql-bridge -- mcp-graphql-bridge
If cloned from source:
claude mcp add --transport stdio \
--env GRAPHQL_API_URL=https://your-api.example.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql \ --env GRAPHQL_TOKEN=your-bearer-token \ graphql-bridge -- node /absolute/path/to/mcp-graphql-bridge/dist/index.js
Important: Make sure to use
mcp-graphql-bridge/dist/index.js(the compiled output), notmcp-graphql-bridge/index.js. The TypeScript source must be built first withnpm run build, and the entry point is in thedist/folder.
Option B: Project scope (shared with your team via .mcp.json)
claude mcp add --transport stdio --scope project \
--env GRAPHQL_API_URL=https://your-api.example.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://your-api.example.com/graphql \ --env GRAPHQL_TOKEN=your-bearer-token \ graphql-bridge -- mcp-graphql-bridge
Note: Use absolute paths. All
--envand--transportflags must come before the server name.
Verify the connection
claude mcp list
Then in a Claude Code session, run /mcp to see available servers and tools.
MCP Registry
This server is published to the official MCP Registry as io.github.murilojrpereira/mcp-graphql-bridge, so MCP clients that browse the registry can discover and install it from there.
Examples
Two worked walkthroughs — a small public schema with no configuration needed, then a large, real enterprise-scale schema requiring auth and tool-count limits.
Example 1: Countries API (small schema, no auth)
This is the zero-config default — nothing to install or configure beyond the server itself.
- Add the server with no environment variables at all:
claude mcp add --transport stdio graphql-countries -- mcp-graphql-bridge
- Restart Claude Code (or run
/mcpto confirmgraphql-countriesis connected). You should see tools likequery__country,query__countries, andquery__continents. - Ask Claude:
Using graphql-countries, find the country with code "BR", then list its continent's other countries.
Claude calls query__country({ code: "BR", __fields: "{ name continent { code name } }" }), then query__continent or query__countries({ __fields: "{ name }" }) filtered by the result.
- Try an invalid code to see error passthrough:
Look up the country with code "ZZZ".
Returns the GraphQL API's own error text — the bridge passes it through rather than masking it.
Example 2: GitHub GraphQL API (large schema, auth + tool limits)
GitHub's GraphQL API has 284 root fields (32 queries, 252 mutations) — far more than the GRAPHQL_MAX_TOOLS default of 128, and it needs a token for every request, including introspection (unlike GitHub's REST API, which allows some anonymous reads).
- Add the server, scoped to read-only access:
export GH_TOKEN=ghp_your_personal_access_token # or: source a gitignored .env file first
claude mcp add --transport stdio graphql-github \ --env GRAPHQL_API_URL=https://api.github.com/graphql \ --env GRAPHQL_INTROSPECTION_URL=https://api.github.com/graphql \ --env GRAPHQL_TOKEN=$GH_TOKEN \ --env GRAPHQL_INCLUDE_MUTATIONS=false \ graphql-bridge -- mcp-graphql-bridge
GRAPHQL_INCLUDE_MUTATIONS=false registers all 32 (read-only) queries and zero mutations — comfortably under the cap, and a meaningfully safer default for an AI agent than exposing all 252 write operations.
- Ask Claude:
Using graphql-github, look up the repository facebook/react and tell me its star count.
Claude calls query__repository({ owner: "facebook", name: "react", __fields: "{ name stargazerCount }" }).
- To also reach mutations, drop
GRAPHQL_INCLUDE_MUTATIONS=falseand raise the cap (GRAPHQL_MAX_TOOLS=400), understanding that this exposes write access to your GitHub account scoped to whatever permissions your token has.
Available tools
| Tool | Description |
|---|---|
query__ | One tool per GraphQL query field |
mutation__ | One tool per GraphQL mutation field |
execute_graphql | Generic fallback — run any query or mutation (mutations rejected if GRAPHQL_INCLUDE_MUTATIONS=false) |
get_type_details | Explore fields of a specific GraphQL type |
All per-operation tools accept a special __fields argument where you can provide a custom GraphQL selection set (e.g. { id name status }). If omitted, only scalar fields are returned.
Per-call auth override: every tool (including execute_graphql) also accepts bearer_token and custom_headers arguments. If provided, they override GRAPHQL_TOKEN/no-auth for that single request only, letting Claude switch credentials per call without restarting the server.
Security
- The target API is fixed per deployment, never a per-request parameter. Individual tool calls can override *credentials* (
bearer_token,custom_headers) but never the destination host —GRAPHQL_API_URLis set once at deployment time. A shared server that let callers redirect it to an arbitrary destination would be a Server-Side Request Forgery (SSRF) primitive; this design rules that out by construction. - Configured and per-call secrets are redacted from every response before it reaches the calling LLM.
- `GRAPHQL_INCLUDE_MUTATIONS=false` excludes every mutation field from registration for a genuinely read-only deployment — a meaningful trust boundary GraphQL's type system already encodes, rather than relying on token scope alone. This is enforced for
execute_graphqltoo: it parses the query and rejects any mutation when this flag is off, rather than only omitting the conveniencemutation__*tools while leaving the generic fallback able to run anything. - `MCP_AUTH_TOKEN` gates the HTTP transport's
/mcpendpoint for public-routable deployments; requests are capped at 10MB.
See docs/architecture.md for the full design rationale and SECURITY.md to report a vulnerability.
Docker
Build the image
docker build -t mcp-graphql-bridge .
Add to Claude Code via Docker
`bas