使用说明
Pixault MCP服务器
模型上下文协议 服务器 皮克索 图像处理CDN。使AI助手能够管理图像、应用转换、浏览文档等。
特性
- 图像管理 --列出、搜索、上传和删除图像
- 文件名解析 --按原始文件名查找图像,或在一次调用中将一批文件名解析为其CDN URL
- 元数据 --读取和编辑Schema.org字段、地理位置、文件夹、自定义标签;条形EXIF
- 文件夹操作 --创建、列出和删除文件夹;按文件夹过滤图像
- 变换 --应用和管理命名转换;构建CDN URL,响应式
<img>/<picture>嵌入并获取Schema.org JSON-LD - 水印 --上传、列出和删除水印图像
- EPS/矢量 --拆分多设计EPS文件,提取SVG,检查衍生资产
- 插件市场 --浏览、激活和停用插件
- 文档 -搜索嵌入的API文档,或将其作为MCP浏览 资源
- 资源 --捆绑文档位于
pixault://docs/{topic}以及实时图像元数据pixault://{project}/{imageId}/metadata
安装
将服务器作为安装。NET工具:
dotnet tool install --global Pixault.Mcp
克劳德桌面/克劳德代码
添加到MCP配置中:
{
"mcpServers": {
"pixault": {
"command": "pixault-mcp",
"env": {
"PIXAULT_BASE_URL": "https://img.pixault.io",
"PIXAULT_PROJECT": "my-project",
"PIXAULT_API_KEY": "your-api-key"
}
}
}
}
来源
git clone https://github.com/Pixault/pixault-mcp.git
cd pixault-mcp
dotnet run --project src/Pixault.Mcp
配置
| 环境变量 | 必填 | 说明 |
|---|---|---|
PIXAULT_BASE_URL |
是 | Pixault CDN基本URL |
PIXAULT_PROJECT |
是 | 默认项目标识符 |
PIXAULT_API_KEY |
是 | 用于身份验证的API密钥 |
PIXAULT_HMAC_SECRET |
无 | 用于生成签名URL的HMAC密钥 |
这个
Pixault__BaseUrl/Pixault__Project(双下划线)形式也适用于每种设置。
代理范围界定
限制AI助手可以通过此服务器执行的操作。读取操作和URL/嵌入 世代总是被允许的;门下的标志是变异工具。
| 环境变量 | 默认值 | 门 |
|---|---|---|
PIXAULT_ALLOW_WRITE |
true |
上传、元数据编辑、转换/水印/文件夹创建、EXIF条带、EPS作业 |
PIXAULT_ALLOW_DELETE |
false |
删除图像、变换、水印、文件夹 |
PIXAULT_ALLOW_PLUGINS |
false |
激活/停用市场插件 |
当一个类别被禁用时,相应的工具会返回一个明确的“权限被拒绝” 消息,而不是执行操作。
资源
除了模型调用的工具外,服务器还公开了只读MCP 资源 主机可以 浏览并附加到上下文:
| URI | 描述 |
|---|---|
pixault://docs |
捆绑文档主题索引 |
pixault://docs/{topic} |
文档页面(例如。 pixault://docs/quick-start) |
pixault://{project}/{imageId}/metadata |
图像的实时Schema.org元数据,格式为JSON |