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 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:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mcpgraph",
3
- "version": "0.1.31",
3
+ "version": "0.1.32",
4
4
  "description": "MCP server that executes directed graphs of MCP server calls",
5
5
  "main": "dist/main.js",
6
6
  "type": "module",