Eelzap MCP Server

@8ux co/eelzap mcp服务器

将您的AI助手连接到 Eel Zap CMS。创建收藏、管理内容、上传媒体和发布——所有这些都是通过自然语言完成的。

适用于Claude Code、Cursor、VS Code、Codex和Claude Desktop。

快速开始

使用CLI（推荐）：

npx @8ux-co/eelzap-mcp-server install

使用克劳德代码：

claude mcp add --transport stdio eelzap \
  --env EELZAP_API_KEY=secret_your_key_here \
  -- npx -y @8ux-co/eelzap-mcp-server

有关其他工具，请参阅 安装指南 在......下面

安装指南

克劳德代码

CLI方法：

npx @8ux-co/eelzap-mcp-server install --tool claude-code

手动方法——项目范围(.mcp.json):

创建 .mcp.json 在项目根目录中：

{
  "mcpServers": {
    "eelzap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@8ux-co/eelzap-mcp-server"],
      "env": {
        "EELZAP_API_KEY": "secret_your_key_here"
      }
    }
  }
}

手动方法——用户范围(~/.claude.json):

添加到 mcpServers 部分 ~/.claude.json:

{
  "mcpServers": {
    "eelzap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@8ux-co/eelzap-mcp-server"],
      "env": {
        "EELZAP_API_KEY": "secret_your_key_here"
      }
    }
  }
}

使用 claude mcp add:

claude mcp add --transport stdio eelzap \
  --env EELZAP_API_KEY=secret_your_key_here \
  -- npx -y @8ux-co/eelzap-mcp-server

光标

CLI方法：

npx @8ux-co/eelzap-mcp-server install --tool cursor

手动方法——项目范围：

创建 .cursor/mcp.json 在项目根目录中：

{
  "mcpServers": {
    "eelzap": {
      "command": "npx",
      "args": ["-y", "@8ux-co/eelzap-mcp-server"],
      "env": {
        "EELZAP_API_KEY": "secret_your_key_here"
      }
    }
  }
}

手动方法——全局范围：

创建或编辑 ~/.cursor/mcp.json 具有相同的结构。

VS代码

CLI方法：

npx @8ux-co/eelzap-mcp-server install --tool vscode

手动方法：

创建 .vscode/mcp.json 在项目根目录中：

{
  "servers": {
    "eelzap": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@8ux-co/eelzap-mcp-server"],
      "env": {
        "EELZAP_API_KEY": "secret_your_key_here"
      }
    }
  }
}

重要提示： VS代码使用 "servers" 作为顶级密钥，不是 "mcpServers".

法典

CLI方法：

npx @8ux-co/eelzap-mcp-server install --tool codex

手动方法：

添加 ~/.codex/config.toml （或 .codex/config.toml 项目范围）：

[mcp_servers.eelzap]
command = "npx"
args = ["-y", "@8ux-co/eelzap-mcp-server"]
enabled = true

[mcp_servers.eelzap.env]
EELZAP_API_KEY = "secret_your_key_here"

克劳德桌面

CLI方法：

npx @8ux-co/eelzap-mcp-server install --tool claude-desktop

手动方法：

在以下位置编辑配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json
• Linux： ~/.config/claude/claude_desktop_config.json

添加到 mcpServers 章节：

{
  "mcpServers": {
    "eelzap": {
      "command": "npx",
      "args": ["-y", "@8ux-co/eelzap-mcp-server"],
      "env": {
        "EELZAP_API_KEY": "secret_your_key_here"
      }
    }
  }
}

保存后重新启动Claude Desktop。

CLI命令

示例：

# Install with flags (non-interactive):
npx @8ux-co/eelzap-mcp-server install \
  --tool claude-code \
  --scope project \
  --api-key secret_xxx

# Update the API key for a specific tool:
npx @8ux-co/eelzap-mcp-server switch-key --tool cursor

# Check what's configured and whether it's working:
npx @8ux-co/eelzap-mcp-server status

# Run diagnostics:
npx @8ux-co/eelzap-mcp-server doctor

配置

环境变量

API密钥类型

对于MCP服务器的使用，您几乎总是希望 密钥 因为关键是要通过你的人工智能助手来管理内容。

本地开发

如果您在本地运行CMS：

"env": {
  "EELZAP_API_KEY": "secret_your_key",
  "EELZAP_BASE_URL": "http://localhost:5041",
  "EELZAP_PATH_PREFIX": "/api/public/v1"
}

可用工具

网站（1个工具）

收藏（5个工具）

收集字段（5个工具）

收集部分（4个工具）

项目（7个工具+7个版本控制工具）

项目版本控制（7个工具）

文档（5个工具+7个版本控制工具）

文档字段（5个工具）

文档部分（4个工具）

文档值（2个工具）

文档发布（2个工具）

文档版本控制（7个工具）

媒体（7工具）

搜索引擎优化（4个工具）

交付API（5个工具）

你能做什么？

连接后，尝试询问您的AI助手：

内容创作

• 创建包含标题、内容、作者和特色图像字段的博客集
• “添加5篇关于web开发最佳实践的博客文章”
• 创建包含英雄标题、描述和团队部分的“关于”页面文档

内容管理

• “列出我的所有集合及其字段架构”
• “将我主页上的英雄头衔更新为‘用人工智能更快地构建’”
• “发布博客收藏中的所有草稿项”

媒体

• “从URL上传此图像，并将其设置为我最新博客文章的特色图像”
• “列出所有媒体资产，并向我显示哪些未发布”

搜索引擎优化

• “为所有博客帖子设置SEO元数据——根据内容生成元标题和描述”
• “检查哪些项目缺少SEO元数据”

网站发现

• 显示我的网站结构——所有集合、文档及其字段
• “我有哪些内容类型？列出所有内容。”

内容分发

• “获取我发布的博客文章，并向我展示交付API返回的内容”
• “检查主页文档是否已发布以及它提供了哪些数据”

故障排除

“需要EELZAP_API_KEY”

服务器找不到您的API密钥。确保它已设置在 env MCP配置的一部分（所有工具，包括Codex） [mcp_servers.eelzap.env]).

“连接被拒绝”或“ECONNREFUSED”

服务器无法访问API。检查：

• 你的 EELZAP_BASE_URL 正确（默认值： https://api.eelzap.com)
• 如果使用本地开发，请确保CMS应用程序在预期端口上运行

“401未经授权”

您的API密钥无效或已过期。从Eel Zap仪表板（设置>API键）生成一个新的，然后运行 eelzap-mcp switch-key.

“403禁止”

您正在使用公钥(public_)用于写入操作。切换到密钥(secret_).

服务器未出现在您的工具中

• 克劳德代码： 重新启动Claude Code或运行 /mcp 检查服务器状态
• 光标： 重新启动游标；检查“设置”>“工具和MCP”以了解服务器状态
• VS代码： 检查MCP面板；尝试命令面板中的“MCP:列出服务器”
• 食品法典： 重新启动Codex；确保TOML配置位于 ~/.codex/config.toml
• 克劳德桌面： 完全退出并重新打开Claude Desktop（配置更改需要重新启动）

工具未加载/“无可用工具”

服务器已启动，但工具未注册。跑 eelzap-mcp doctor 以诊断或检查服务器日志在启动过程中是否有错误。

发展

git clone https://github.com/8ux-co/eelzap-mcp-server.git
cd eelzap-mcp-server
npm install
npm run build
npm test

在开发过程中本地运行：

EELZAP_API_KEY=secret_... npx tsx src/index.ts

MCP检验员测试：

EELZAP_API_KEY=secret_... npx @modelcontextprotocol/inspector npx tsx src/index.ts