Claude Code example

[arthurwolf]

Hey, very cool project, thanks for sharing it with the world.

It'd be great if the documentation had an easy tutorial/example on how to set this up with claude code and/or codex, and/or other CLI coding agents.

If somebody gives me pointers on how to get that going, I can work on a small PR once I have gotten it going locally.

Also, I see there is a MCP bridge (@utcp/mcp-bridge) from the README, but it's really not clear from reading the README if just setting up that MCP in my claude code will give me a bunch of tools already set up that will immediately give me the benefits the README claims, or if I need to actually take a bunch of time to write tool definitions/connect everything together. Also it mentions a json config file but so far I haven't figured out how to use that/what to fill it with, maybe an example config file with "generally useful for coding" settings would be nice to provide? Like the README makes some very impressive claims about 88% gains etc, but then doesn't seem to give me a very straightforward route to getting those gains myself... If it worked for you shouldn't there be a (relatively) straight route for me to get there too?

Or maybe I'm just very confused about what this is and how this works, I don't know.

Cheers.

[joshbalfour]

I've just migrated from using MCP servers in claude code, this is all i had to change:

--- a/.claude.json
+++ b/.claude.json
@@ -1,21 +1,12 @@
 {
     "mcpServers": {
-        "figma-desktop": {
-            "type": "http",
-            "url": "http://host.docker.internal:3845/mcp"
-        },
-        "atlassian": {
-            "type": "http",
-            "url": "http://host.docker.internal:${atlassian_PORT}/mcp"
-        },
-        "cloudflare": {
-            "type": "http",
-            "url": "https://docs.mcp.cloudflare.com/mcp"
-        },
-        "playwright": {
-            "type": "http",
-            "url": "http://host.docker.internal:${playwright_PORT}/mcp"
+        "utcp": {
+            "command": "npx",
+            "args": ["@utcp/code-mode-mcp"],
+            "env": {
+                "UTCP_CONFIG_FILE": "/root/.utcp_config.json"
+            }
         }
     },
}

--- /dev/null
+++ b/.utcp_config.json
@@ -0,0 +1,52 @@
+{
+    "manual_call_templates": [
+        {
+            "name": "playwright",
+            "call_template_type": "mcp",
+            "config": {
+                "mcpServers": {
+                    "playwright": {
+                        "transport": "http",
+                        "url": "http://host.docker.internal:${PORT}/mcp"
+                    }
+                }
+            }
+        },
+        {
+            "name": "atlassian",
+            "call_template_type": "mcp",
+            "config": {
+                "mcpServers": {
+                    "atlassian": {
+                        "transport": "http",
+                        "url": "http://host.docker.internal:${PORT}/mcp"
+                    }
+                }
+            }
+        },
+        {
+            "name": "figma",
+            "call_template_type": "mcp",
+            "config": {
+                "mcpServers": {
+                    "figma": {
+                        "transport": "http",
+                        "url": "http://host.docker.internal:3845/mcp"
+                    }
+                }
+            }
+        },
+        {
+            "name": "cloudflare",
+            "call_template_type": "mcp",
+            "config": {
+                "mcpServers": {
+                    "cloudflare": {
+                        "transport": "http",
+                        "url": "https://docs.mcp.cloudflare.com/mcp"
+                    }
+                }
+            }
+        }
+    ]
+}
\ No newline at end of file

Everything worked out of the box from there.

Note:

• the use of @utcp/code-mode-mcp rather than UTCP mcp (per Mcp usage, do not allow to call tools with code. #3 (comment))
• env var name definition remaining the same but their usage changing since they're scoped to the name of the template you're in https://github.com/universal-tool-calling-protocol/typescript-utcp?tab=readme-ov-file#variable-resolution-order

Hope this helps!

[DoiiarX]

I've just migrated from using MCP servers in claude code, this is all i had to change:

--- a/.claude.json
+++ b/.claude.json
@@ -1,21 +1,12 @@
{
"mcpServers": {

•    "figma-desktop": {
  

•        "type": "http",
  

•        "url": "http://host.docker.internal:3845/mcp"
  

•    },
  

•    "atlassian": {
  

•        "type": "http",
  

•        "url": "http://host.docker.internal:${atlassian_PORT}/mcp"
  

•    },
  

•    "cloudflare": {
  

•        "type": "http",
  

•        "url": "https://docs.mcp.cloudflare.com/mcp"
  

•    },
  

•    "playwright": {
  

•        "type": "http",
  

•        "url": "http://host.docker.internal:${playwright_PORT}/mcp"
  

•    "utcp": {
  

•        "command": "npx",
  

•        "args": ["@utcp/code-mode-mcp"],
  

•        "env": {
  

•            "UTCP_CONFIG_FILE": "/root/.utcp_config.json"
  

•        }
     }
  

  },
  }
  --- /dev/null
  +++ b/.utcp_config.json
  @@ -0,0 +1,52 @@
  +{
• "manual_call_templates": [

•    {
  

•        "name": "playwright",
  

•        "call_template_type": "mcp",
  

•        "config": {
  

•            "mcpServers": {
  

•                "playwright": {
  

•                    "transport": "http",
  

•                    "url": "http://host.docker.internal:${PORT}/mcp"
  

•                }
  

•            }
  

•        }
  

•    },
  

•    {
  

•        "name": "atlassian",
  

•        "call_template_type": "mcp",
  

•        "config": {
  

•            "mcpServers": {
  

•                "atlassian": {
  

•                    "transport": "http",
  

•                    "url": "http://host.docker.internal:${PORT}/mcp"
  

•                }
  

•            }
  

•        }
  

•    },
  

•    {
  

•        "name": "figma",
  

•        "call_template_type": "mcp",
  

•        "config": {
  

•            "mcpServers": {
  

•                "figma": {
  

•                    "transport": "http",
  

•                    "url": "http://host.docker.internal:3845/mcp"
  

•                }
  

•            }
  

•        }
  

•    },
  

•    {
  

•        "name": "cloudflare",
  

•        "call_template_type": "mcp",
  

•        "config": {
  

•            "mcpServers": {
  

•                "cloudflare": {
  

•                    "transport": "http",
  

•                    "url": "https://docs.mcp.cloudflare.com/mcp"
  

•                }
  

•            }
  

•        }
  

•    }
  

• ]
  +}
  \ No newline at end of file
  Everything worked out of the box from there.

Note:

• the use of @utcp/code-mode-mcp rather than UTCP mcp (per Mcp usage, do not allow to call tools with code. #3 (comment))
• env var name definition remaining the same but their usage changing since they're scoped to the name of the template you're in https://github.com/universal-tool-calling-protocol/typescript-utcp?tab=readme-ov-file#variable-resolution-order

Hope this helps!

is it support sse?I couldn't load sse tools