ElmapiCMS MCP服务器
连接AI代理的MCP（模型上下文协议）服务器，如 光标 和 克劳德代码 致你的 ElmapiCMS 例子通过自然语言以编程方式管理集合、字段、内容条目和资产。
安装
npm install -g @elmapicms/mcp-server或在本地安装：
npm install @elmapicms/mcp-server配置
服务器需要三个环境变量：
| 变量 | 描述 |
|---|---|
ELMAPI_API_URL | 基本API URL（例如。， https://your-domain.com/api) |
ELMAPI_API_KEY | 具备所需能力的API令牌 |
ELMAPI_PROJECT_ID | 项目UUID |
使用游标
将此添加到光标MCP设置中(~/.cursor/mcp.json):
{
"mcpServers": {
"elmapicms": {
"command": "npx",
"args": ["@elmapicms/mcp-server"],
"env": {
"ELMAPI_API_URL": "https://your-domain.com/api",
"ELMAPI_API_KEY": "your-api-key",
"ELMAPI_PROJECT_ID": "your-project-uuid"
}
}
}
}使用Claude代码
使用Claude Code CLI添加MCP服务器：
claude mcp add elmapicms \
-e ELMAPI_API_URL=https://your-domain.com/api \
-e ELMAPI_API_KEY=your-api-key \
-e ELMAPI_PROJECT_ID=your-project-uuid \
-- npx @elmapicms/mcp-server本地开发（Laravel Herd/.test域）
如果您的ElmapiCMS实例在 .test 使用自签名SSL证书的域（例如，通过Laravel Herd），将以下内容添加到您的env配置中：
"env": {
"ELMAPI_API_URL": "https://myproject.test/api",
"ELMAPI_API_KEY": "your-api-key",
"ELMAPI_PROJECT_ID": "your-project-uuid",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}注： 仅限使用 NODE_TLS_REJECT_UNAUTHORIZED=0 为了地方发展。不要在生产中使用它。可用工具（17）
项目
get_project--获取项目信息
集合
list_collections--列出所有收藏get_collection--获取具有完整字段架构的集合create_collection--创建集合（可选择创建批处理字段）update_collection--更新收藏的名称和slugreorder_collections--重新订购系列
领域
create_field--向集合中添加字段update_field--更新字段reorder_fields--重新排序集合中的字段
内容条目
list_entries--列出具有高级筛选功能的条目(where具有13个运算符、OR组、关系过滤）、排序、分页、计数和第一get_entry--获取单个内容条目create_entry--创建内容条目update_entry--更新内容条目delete_entry--软删除内容条目（移动到垃圾箱）
资产
list_assets--按页码列出资产get_asset--通过UUID或文件名获取资产upload_asset--将文件作为资产上传delete_asset--删除资产
资源
服务器公开了三个参考资源，AI代理可以读取这些资源以获取上下文：
- 字段类型参考 (
elmapicms://field-types)--所有16种字段类型及其选项、验证和常见模式的完整参考。 - 收藏指南 (
elmapicms://collections-guide)--使用集合、单例、保留蛞蝓和最佳实践的指南。 - 查询参考 (
elmapicms://query-reference)--内容查询的完整文档：where具有13个运算符的过滤器、OR组、关系过滤、排序、分页和示例。
代币能力
您的API令牌需要为您要使用的工具提供适当的功能：
| 能力 | 工具 |
|---|---|
read | 列出/获取集合、条目、资产 |
create | 创建条目，上传资产 |
update | 更新条目 |
delete | 删除条目，删除资产 |
admin | 创建/更新/重新排序集合和字段 |
您可以从项目的 设置>API访问 页面。
使用多个项目
每个MCP服务器实例都连接到一个项目。要处理多个项目，请在MCP配置中添加单独的条目：
{
"mcpServers": {
"elmapicms-blog": {
"command": "npx",
"args": ["@elmapicms/mcp-server"],
"env": {
"ELMAPI_API_URL": "https://your-domain.com/api",
"ELMAPI_API_KEY": "blog-project-api-key",
"ELMAPI_PROJECT_ID": "blog-project-uuid"
}
},
"elmapicms-store": {
"command": "npx",
"args": ["@elmapicms/mcp-server"],
"env": {
"ELMAPI_API_URL": "https://your-domain.com/api",
"ELMAPI_API_KEY": "store-project-api-key",
"ELMAPI_PROJECT_ID": "store-project-uuid"
}
}
}
}许可证
麻省理工学院