mcpgraph 0.1.31 → 0.1.32
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 +3 -0
- package/docs/building.md +1 -12
- package/docs/no-code-code-mode.md +4 -0
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -6,6 +6,8 @@ MCP server that executes directed graphs of MCP server calls.
|
|
|
6
6
|
|
|
7
7
|
> **🎥 Watch the Demo:** Check out the [**mcpGraph Overview and mcpGraphUX Demo**](https://youtu.be/eyC7OzuB6c4) video to see mcpGraph in action and explore the visual debugging capabilities of mcpGraphUX.
|
|
8
8
|
|
|
9
|
+
> **🎥 Watch the Demo:** Check out the [**mcpGraphToolkit Deep Dive**](https://youtu.be/gR7s0MD8Gro) video to see an agent autonomously build, test, and deploy orchestration tools—"Code Mode" without the code.
|
|
10
|
+
|
|
9
11
|
## Overview
|
|
10
12
|
|
|
11
13
|
mcpGraph is an MCP (Model Context Protocol) server that exposes tools defined by declarative YAML configurations. Each tool executes a directed graph of nodes that can call other MCP tools, transform data, and make routing decisions, all without embedding a full programming language.
|
|
@@ -18,6 +20,7 @@ mcpGraph is an MCP (Model Context Protocol) server that exposes tools defined by
|
|
|
18
20
|
- **No Embedded Code**: All logic expressed using standard expression languages ([JSONata](https://jsonata.org/), [JSON Logic](https://jsonlogic.com/))
|
|
19
21
|
|
|
20
22
|
**Related Tools:**
|
|
23
|
+
- **mcpGraphUX**: A visual debugging and development environment for mcpGraph. Visualize graph structures, animate through active nodes during execution, set breakpoints, and inspect node inputs and outputs. See the [mcpGraphUX repository](https://github.com/TeamSparkAI/mcpGraph-ux) for details.
|
|
21
24
|
- **mcpGraphToolkit**: An MCP server that provides tools for building, testing, and managing mcpGraph tools. Use it to discover available MCP servers, test expressions, and create graph tools interactively. See [mcpGraphToolkit Overview](docs/toolkit.md) for details.
|
|
22
25
|
|
|
23
26
|
## Example
|
package/docs/building.md
CHANGED
|
@@ -163,6 +163,7 @@ Verify: No fetch or filesystem tool installed in agent
|
|
|
163
163
|
Install mcpGraphToolkit in agent
|
|
164
164
|
- place agent.yaml and mcp.json where installed mcpGraphToolkit can see them
|
|
165
165
|
- install
|
|
166
|
+
|
|
166
167
|
Prompt to create new tool
|
|
167
168
|
|
|
168
169
|
Prompt (two steps):
|
|
@@ -178,15 +179,3 @@ Download the text contents of the web page https://world.hey.com/dhh/pay-yoursel
|
|
|
178
179
|
DevRel prompt:
|
|
179
180
|
|
|
180
181
|
What did you struggle with in building that tool and how could the skill.md documentation or the mcpgraphtoolkit tooling be improved to help
|
|
181
|
-
|
|
182
|
-
NOTES:
|
|
183
|
-
|
|
184
|
-
First pass had a "graph/node" structure, no input node, malformed graph/output node, dependsOn elements - basically crazytown, second pass was correct
|
|
185
|
-
- Agent detected error and rebuilt it correctly, so that's good
|
|
186
|
-
|
|
187
|
-
Check relative path support in .mcp.json mcpgraphtoolkit config
|
|
188
|
-
|
|
189
|
-
Test Claude-generated graph in UX (debug, validate)
|
|
190
|
-
|
|
191
|
-
Move entire test Claude project into mcpGraph repo?
|
|
192
|
-
- Might only make sense of relative paths worked
|
|
@@ -93,6 +93,8 @@ But that's not what we're talking about. We're talking about a solution where we
|
|
|
93
93
|
|
|
94
94
|
**mcpGraph** is a Domain Specific Language (DSL) for MCP tool orchestration. It uses a declarative configuration—a YAML file—to define an MCP server and a set of tools, where those tools are implemented as directed graphs that can orchestrate other MCP tools (with data transformation and conditional logic support). It's Code Mode without the code.
|
|
95
95
|
|
|
96
|
+
> **🎥 Watch the Demo:** Check out the [**mcpGraph Overview and mcpGraphUX Demo**](https://youtu.be/eyC7OzuB6c4) video to see mcpGraph in action and explore the visual debugging capabilities of mcpGraphUX.
|
|
97
|
+
|
|
96
98
|
### **Core Features:**
|
|
97
99
|
|
|
98
100
|
* **Declarative Config:** Define tools and execution graphs in YAML.
|
|
@@ -248,6 +250,8 @@ Assuming your agent can build and install an MCP server into it's own environmen
|
|
|
248
250
|
|
|
249
251
|
We also wanted a viable end-to-end solution where any agent could create and deploy mcpGraph tools. This means that we not only need to instruct the agent on tool creation, but we need to provide the agent with tooling to understand available MCP servers and to test and deploy mcpGraph tools into its own environment. To that end, we created mcpGraphToolkit, an MCP server that provides a full set of development, test, and deployment tools to an agent. We have a separate [SKILL.md](../skills/mcpGraphToolkit/SKILL.md) file to support agents in using the mcpGraphToolkit.
|
|
250
252
|
|
|
253
|
+
> **🎥 Watch the Demo:** Check out the [**mcpGraphToolkit Deep Dive**](https://youtu.be/gR7s0MD8Gro) video to see an agent autonomously build, test, and deploy orchestration tools—"Code Mode" without the code.
|
|
254
|
+
|
|
251
255
|
The **mpcGraphToolkit** is installed as part of the mcpGraph package, so if you've installed mcpGraph from npm, you already have mcpGraphToolkit available.
|
|
252
256
|
|
|
253
257
|
To use mcpGraphToolkit in your agent:
|