@letoribo/mcpgql 1.2.1 → 1.2.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +63 -0
- package/package.json +4 -2
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# mcpgql
|
|
2
|
+
|
|
3
|
+
**The GraphQL Overlord’s bridge to MCP.**
|
|
4
|
+
|
|
5
|
+
`mcpgql` is not just a client; it's a federated bridge connecting any GraphQL endpoint directly to the Model Context Protocol (MCP) ecosystem.
|
|
6
|
+
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
## Why mcpgql?
|
|
10
|
+
|
|
11
|
+
- **Zero-Config Integration**: Seamlessly connect LLMs to your graph data.
|
|
12
|
+
- **No Environment Pollution**: Unlike standard setups, no environment variables need to be declared in your `claude_desktop_config.json`. All configuration (endpoints, headers, mutation toggles) is handled dynamically in your terminal gateway.
|
|
13
|
+
- **Federated Power**: Engineered to work flawlessly with `mcp-remote` for decentralized, multi-endpoint environments.
|
|
14
|
+
- **Real-time Mutations**: Full support for write operations (like `publishToDiscord`) directly from your AI agent.
|
|
15
|
+
|
|
16
|
+
## Quick Start
|
|
17
|
+
|
|
18
|
+
Run the bridge via the terminal command:
|
|
19
|
+
```
|
|
20
|
+
mcpgql
|
|
21
|
+
```
|
|
22
|
+
The interactive dialog will automatically guide you through setting up your endpoints and required environment variables:
|
|
23
|
+
```
|
|
24
|
+
--- Select Endpoints (Enter to confirm) ---
|
|
25
|
+
[✓] 1. mcp
|
|
26
|
+
[ ] 2. neo4j
|
|
27
|
+
--- Environment variables ---
|
|
28
|
+
[YES] 3. Allow Mutations
|
|
29
|
+
[OK] 4. Headers (Loaded from: /home/atman/headers.json)
|
|
30
|
+
|
|
31
|
+
Enter number to toggle (or Enter to proceed):
|
|
32
|
+
|
|
33
|
+
1. Terminal (HTTP GraphQL Gateway)
|
|
34
|
+
2. MCP Inspector (stdio)
|
|
35
|
+
Select mode (1 or 2): 1
|
|
36
|
+
[INFO] Launching with ENDPOINT=https://mcp-discord.vercel.app/api/graphiql
|
|
37
|
+
[DEBUG] Executing: node /home/mcp-graphql-enhanced/dist/index.js
|
|
38
|
+
[BOOT] Initializing schema sync for: https://mcp-discord.vercel.app/api/graphiql
|
|
39
|
+
[SYSTEM] Federated Bridge active on port 6274
|
|
40
|
+
📡 MCP Endpoint: http://localhost:6274/mcp
|
|
41
|
+
🎨 GraphiQL: http://localhost:6274/graphiql
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
## Integrate into Claude Desktop with a minimal configuration:
|
|
45
|
+
```
|
|
46
|
+
{
|
|
47
|
+
"mcpServers": {
|
|
48
|
+
"mcpgql": {
|
|
49
|
+
"command": "npx",
|
|
50
|
+
"args": [
|
|
51
|
+
"-y",
|
|
52
|
+
"mcp-remote",
|
|
53
|
+
"http://localhost:6274/mcp"
|
|
54
|
+
]
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
```
|
|
59
|
+
## Proof of Concept
|
|
60
|
+
|
|
61
|
+
- **Real-time Mutation**: Successfully executed complex GraphQL mutations (`publishToDiscord`) directly from the Claude interface.
|
|
62
|
+
- **Integration Log**: [View the live integration proof for this session](https://claude.ai/share/7053179e-8cd7-47b6-bd88-a1f43b28539f).
|
|
63
|
+
- **Success Status**: The integration verifies node querying and response transmission with 100% precision.
|
package/package.json
CHANGED
|
@@ -1,7 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@letoribo/mcpgql",
|
|
3
|
-
"version": "1.2.
|
|
3
|
+
"version": "1.2.3",
|
|
4
4
|
"description": "CLI tool for MCP GraphQL Enhanced",
|
|
5
|
+
"repository": "github:letoribo/mcpgql",
|
|
5
6
|
"main": "index.js",
|
|
6
7
|
"bin": {
|
|
7
8
|
"mcpgql": "index.js"
|
|
@@ -9,7 +10,8 @@
|
|
|
9
10
|
"files": [
|
|
10
11
|
"index.js",
|
|
11
12
|
"core.ts",
|
|
12
|
-
"mcpgql.config.json"
|
|
13
|
+
"mcpgql.config.json",
|
|
14
|
+
"README.md"
|
|
13
15
|
],
|
|
14
16
|
"scripts": {
|
|
15
17
|
"test": "echo \"Error: no test specified\" && exit 1"
|