MCP Codemode Templates

MCPAI代理

提供方 QuentinCody · 包名 @modelcontextprotocol/inspector

AI代理 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaude
查看接入方式

一个在Cloudflare Workers上实现的远程MCP服务器,提供沙盒化V8隔离环境中的JavaScript执行和SQL数据库功能,适用于AI代理开发。

一句话选型结论

按资料字段整理

MCP Codemode Templates 属于AI代理类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

云计算TypeScript本地部署沙盒执行SQL数据库AI代理无认证服务

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Codemode Templates当前 5 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方QuentinCody上游标注的维护方 QuentinCody
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.4 KB
来自项目仓库与上游目录的原文,未做删改

代码模式MCP服务器(无身份验证)

Cloudflare Workers上的远程MCP服务器实现了 代码模式 模式——一个通用的计算+存储平台,AI代理通过MCP连接,获取类型化API,并可以在沙盒V8隔离中执行代码。

  • DO中的SQLite --每个实例的完整SQL数据库(高达10GB,零延迟)
  • 代码模式 --使用类型化工具访问在沙盒V8隔离中执行JavaScript
  • 无身份验证 --公共接入,发展和专用网络的理想选择

开始使用```bash

npm install
npm run dev


服务器运行于 `http://localhost:8788`

- 主页: `http://localhost:8788/`
- MCP端点: `http://localhost:8788/mcp`

## 可用工具

### 存储(SQL)

|工具|参数|描述|
|------|--------|-------------|
| `sql_query` | `query`, `params?` |执行SELECT/PRAGMA/EXPLAIN查询。以JSON格式返回行。 |
| `sql_exec` | `query`, `params?` |执行DDL/DML(创建表、插入、更新、删除)。 |
| `sql_exec_batch` | `statements` |在一次调用中执行多个DDL/DML语句。比打电话快得多 `sql_exec` 在一个循环中。 |

代理可以创建自己的表、索引,并完全通过SQL管理数据。参数化查询可防止注入。 `sql_exec` 和 `sql_exec_batch` 为安全起见,应阻断连接、拆卸和载荷释放。

### 计算(代码模式)

|工具|参数|描述|
|------|--------|-------------|
| `execute_code` | `code` |在沙盒V8隔离中执行JavaScript,并通过以下方式访问所有工具 `codemode` 对象。 |
| `get_type_schema` |(none)|返回所有工具的TypeScript类型定义,以便代理可以编写类型良好的代码。 |

## 代码模式如何工作

1. **客服电话 `get_type_schema`** 获取所有可用工具的TypeScript定义
1. **代理编写JavaScript代码** 以这些类型为指导
1. **客服电话 `execute_code`** 使用代码字符串
1. **代码在沙盒V8隔离中运行** 带着一个 `codemode` 代理对象
1. **隔离中的工具调用** (例如。, `codemode.sql_query(...)`)路由回MCP服务器
1. **结果返回** 给代理人

### 示例流程```
Agent → get_type_schema()
Agent ← TypeScript definitions

Agent → execute_code({
code: `
await codemode.sql_exec({
query: "CREATE TABLE IF NOT EXISTS notes (id INTEGER PRIMARY KEY, title TEXT, body TEXT)"
});
await codemode.sql_exec({
query: "INSERT INTO notes (title, body) VALUES (?, ?)",
params: ["Hello", "World"]
});
const notes = await codemode.sql_query({ query: "SELECT * FROM notes" });
return notes;
`
})
Agent ← [{ id: 1, title: "Hello", body: "World" }]

> 注: Worker Loader API可能需要Cloudflare测试版访问。这 execute_code 如果LOADER绑定不可用,该工具将优雅地出错。所有其他工具都独立于代码模式工作。

与MCP检查员联系```bash

npx @modelcontextprotocol/inspector


进入 `http://localhost:8788/mcp` 作为MCP服务器URL。

## 与克劳德桌面连接

添加到您的Claude桌面配置(`Settings > Developer > Edit Config`):```json
{
"mcpServers": {
"codemode": {
"command": "npx",
"args": ["mcp-remote", "http://localhost:8788/mcp"]
}
}
}

部署到Cloudflare```bash

npm run deploy


然后更新Claude Desktop配置以使用部署的URL:```
https://remote-mcp-server-authless..workers.dev/mcp

建筑```

┌─────────────────────────────────────────────────────────────────┐
│ MCP Client (Claude Desktop, Inspector, etc.) │
└──────────────────────────┬──────────────────────────────────────┘
│ Streamable HTTP (/mcp)
▼
┌─────────────────────────────────────────────────────────────────┐
│ Cloudflare Worker (HTTP Router) │
│ src/index.ts │
└──────────────────────────┬──────────────────────────────────────┘
│ Routes to Durable Object
▼
┌─────────────────────────────────────────────────────────────────┐
│ MyMCP (Durable Object) │
│ src/mcp-shared/agent.ts │
│ │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ ToolRegistry │ │
│ │ Registers tools, routes isolate calls, generates types │ │
│ └──────┬──────────────────────────────────┬─────────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────────────┐ │
│ │ SQLite-in-DO │ ◄── Extension 1 │ Code Mode │ │
│ │ │ │ │ │
│ │ sql_query │ │ execute_code │ │
│ │ sql_exec │ │ get_type_schema │ │
│ │ sql_exec_ │ └──────────┬───────────┘ │
│ │ batch │ │ │
│ │ │ │ Worker Loader │
│ │ Embedded │ ▼ │
│ │ SQLite DB │ ┌──────────────────────┐ │
│ │ (up to 10GB)│ │ V8 Isolate │ │
│ │ │ │ (sandboxed) │ │
│ │ this.sql │ │ │ │
│ │ tagged │ │ User code runs here │ │
│ │ template │ │ with codemode │ │
│ │ │ │ proxy object │ │
│ └──────────────┘ └──────────┬───────────┘ │
│ ▲ │ │
│ │ ┌───────────────────┐ │ │
│ │ │ CodeModeProxy │◄──┘ │
│ │ │ (service binding)│ RPC call │
│ │ └────────┬──────────┘ │
│ │ │ Routes back to DO │
│ │ ▼ │
│ └───── registry.handleIsolateCall() ───────────────────│
│ (tool call completes, result returns to isolate) │
└─────────────────────────────────────────────────────────────────┘
```

这些碎片是如何组合在一起的

  • MCP服务器(核心) --The MyMCP 持久对象扩展了Cloudflare的 McpAgent 类。它承载MCP协议,管理会话,并拥有 ToolRegistry 所有工具都已注册。

  • 扩展1:DO中的SQLite --每个DO实例都有一个嵌入式SQLite数据库,可通过以下方式访问 this.sql (标记的模板文字)。SQL工具(sql_query, sql_exec, sql_exec_batch)通过语句验证提供安全、参数化的访问。

  • 扩展2:代码模式 -通过Cloudflare的Worker Loader API执行沙盒JavaScript。用户代码在临时V8隔离中运行 codemode 代理对象。隔离内部的工具调用(例如。, codemode.sql_query(...))路线通过 CodeModeProxy (自引用服务绑定)返回DO ToolRegistry,它会分派给适当的工具处理程序。结果返回到隔离区。

  • 自包含模板 --在中包含共享运行时的供应商副本 src/mcp-shared/ 因此Deploy to Workers可以直接从仓库构建

定制

工具定义见 src/mcp-shared/tools/。要添加新工具,请执行以下操作:

  1. 在中创建新文件 src/mcp-shared/tools/
  2. 出口A ToolEntry[] 数组(参见 src/mcp-shared/tools/sql.ts 图案)
  3. 在中注册工具 src/mcp-shared/agent.ts 在 init() 方法via this.registry.add(...yourTools)

注册表自动处理MCP注册、隔离呼叫路由和类型生成,无需手动 callTool() 案件需要。类型生成的工具定义来自 registry.getDefinitions().

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
MCP Codemode Templates 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

MCP Codemode Templates 怎么在 Claude Desktop、Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Codemode Templates 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Codemode Templates 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Codemode Templates 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Codemode Templates 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 云计算、TypeScript、Claude。具体工具清单以官方文档为准。

MCP Codemode Templates 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

MCP Codemode Templates 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。