MCX (Modular Code Execution)

MCX-模块化代码执行

███╗   ███╗ ██████╗██╗  ██╗
████╗ ████║██╔════╝╚██╗██╔╝
██╔████╔██║██║      ╚███╔╝
██║╚██╔╝██║██║      ██╔██╗
██║ ╚═╝ ██║╚██████╗██╔╝ ██╗
╚═╝     ╚═╝ ╚═════╝╚═╝  ╚═╝

MCP服务器，允许AI代理执行代码，而不是直接调用工具。

基于 Anthropic的代码执行文章.

问题

传统的MCP有两个低效之处：

1. 工具定义过载 -加载所有工具定义洪泛上下文
2. 中间结果膨胀 -每个API响应都通过模型

解决方案

代理不直接调用工具 编写代码 它在沙盒中运行：

const invoices = await api.getInvoices({ limit: 100 });
return {
  count: invoices.length,
  total: sum(invoices, 'amount'),
  byStatus: count(invoices, 'status')
};
// Returns ~50 tokens instead of 50,000

结果：代币减少98% 通过过滤执行环境内的数据。

安装

# Install globally with bun
bun add -g @papicandela/mcx-cli

# Initialize global directory (~/.mcx/)
mcx init

需要Bun： MCX在运行时使用Bun。 安装Bun 如果你还没有。

快速开始

# 1. Initialize global MCX directory
mcx init

# 2. Generate adapters from API docs
mcx gen ./api-docs.md -n myapi

# 3. Add credentials to ~/.mcx/.env

# 4. Start server
mcx serve

目录结构

~/.mcx/
├── adapters/           # Your adapters
│   ├── supabase.ts     # Supabase Management API
│   ├── chrome-devtools.ts  # Chrome DevTools Protocol
│   └── myapi.ts        # Generated from OpenAPI
├── skills/             # Reusable skills
├── mcx.config.ts       # Auto-loads all adapters
├── .env                # API credentials
└── package.json        # Dependencies

# Runtime (created automatically)
~/.mcx/
├── logs/               # Server logs (mcx logs to view)
└── .cache/             # FTS5 search index

Claude代码集成

添加到您的克劳德代码设置(~/.claude.json 或项目的 .mcp.json):

{
  "mcpServers": {
    "mcx": {
      "command": "mcx",
      "args": ["serve"]
    }
  }
}

就是这样！MCX自动使用 ~/.mcx/ 用于配置和适配器。

克劳德代码挂钩（可选）

将本机工具重定向到MCX替代品以获得更好的性能：

~/.claude/settings.json：

{
  "hooks": {
    "PreToolUse": [
      { "matcher": "Grep", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
      { "matcher": "Glob", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
      { "matcher": "Edit", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
      { "matcher": "Write", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-redirect.js" }] },
      { "matcher": "Read", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-read-check.js" }] },
      { "matcher": "Bash", "hooks": [{ "type": "command", "command": "bun ~/.claude/hooks/mcx-bash-check.js" }] }
    ]
  }
}

看 Hooks集成 用于钩子脚本。

主要特点

MCP工具

CLI命令

看 CLI文档 了解详情。

包括适配器

从OpenAPI文档生成自己的适配器：

mcx gen ./api-docs.md -n myapi

内置助手

沙盒中可用的功能：

pick(data, ['id', 'name'])     // Extract fields
first(data, 5)                  // First N items
sum(data, 'amount')             // Sum numeric field
count(data, 'status')           // Count by field
table(data, 10)                 // Markdown table

// Async helpers
await poll(fn, { interval: 2000, maxIterations: 5 })  // Poll until done
await waitFor(fn, { timeout: 30000 })                  // Wait for condition

文件查询辅助工具

使用时 mcx_file({ path, storeAs }) 要将文件加载到沙盒中，请执行以下操作：

// Load file without returning content to context (99% token savings)
mcx_file({ path: "src/large-file.ts", storeAs: "src" })

// Then query with helpers:
around($src, 150, 10)          // 10 lines around line 150
lines($src, 100, 120)          // Get lines 100-120 (1-indexed, inclusive)
block($src, 150)               // Extract code block by indentation
grep($src, "TODO", 3)          // Search with 3 lines context
outline($src)                  // Extract function/class signatures

文档

• CLI命令 -详细的命令参考
• 适配器 -创建和生成适配器
• 技能 -可重复使用的操作
• 配置 -配置文件引用
• 程序化API -在代码中使用MCX
• 安全 -沙盒安全层

发展

git clone https://github.com/schizoidcock/mcx
cd mcx
bun install
bun run build

许可证

麻省理工学院