MCP-TaTTTy
______________________________________________________________________
这是一个MCP(模型上下文协议)用于人工智能纹身图像生成和操作的服务器。使用Stability AI的高级图像生成模型生成数千种不同风格、形状、颜色、大小和位置的纹身设计。
此服务器直接连接到 稳定性AIs 托管REST API。你需要注册一个 来自stability.ai的API密钥 开始吧。
他们免费提供25个学分。之后, 现收现付定价 非常合理:0.01美元/学分,其中3个学分可以让你在他们的Core模型上生成图像。
该项目与Stability AI没有正式关联。
目录
亮点
无学习曲线:此服务器旨在使用合理的默认值,并为与生成和操作图像文件相关的最常见操作提供简单、流畅的用户体验。你不需要技术或了解任何关于图像模型的知识就能有效地使用它。
链条操纵:您可以生成图像,然后替换其中的项目,然后删除背景。…一切都在克劳德的一次谈话中。
最小配置:您需要开始的只是一个Stability AI API密钥。为此设置环境变量和存储输出图像的本地目录路径,您就可以开始了。
利用一流的图像模型:Stability AI是通过API曝光的图像模型的领先提供商。使用此服务器将它们集成到Claude或另一个MCP客户端中,这比在ChatGPT中使用DALL-E模型的体验要好得多。
能力
此服务器是在macOS上使用Claude Desktop构建和测试的。它也应该与其他MCP客户端一起工作。
| 工具名称 | 描述 | 估计稳定性API成本 |
|---|---|---|
generate-image-sd35 | 使用具有高级配置选项的Stable Diffusion 3.5型号生成图像。 | $0.04-$0.07 |
remove-background | 从图像中删除背景。 | $0.02 |
upscale-creative | 将图像分辨率提高到4K。 | $0.25 |
control-structure | 在保持参考图像结构的同时生成图像。 | $0.03 |
使用技巧
- 所有处理后的图像都会自动保存到
IMAGE_STORAGE_DIRECTORY,打开预览,并作为资源提供 - 做 _不_ 尝试将图像文件复制/粘贴或上传到Claude。Claude不会在任何地方存储图像,因此我们无法使用MCP服务器。它们必须“上传”(保存到)
IMAGE_STORAGE_DIRECTORY然后它们将显示为聊天中可用的资源。 - 你可以使用预装的提示,而不是写自己的措辞:
例子
使用SD3.5生成图像
Generate an image of a woman with cybernetic wolf ears using the SD3.5 model, with the "neon-punk" style presetGenerate an image of a futuristic city using the SD3.5 Large Turbo model, with aspect ratio 16:9Generate an image of an astronaut on mars using the SD3.5 Large model, with cfg scale 7.5, "analog-film" style preset, and seed 42
删除背景
Remove the background from the image I just generatedRemove the background from product-photo.jpg to prepare it for my e-commerce siteRemove the background from group-photo.png so I can composite it with another image
高档
Upscale profile-pic.jpg for better resolutionUpscale product-photo.png to make it print-ready
然后,如果输出仍然不够好,你可以再次升级:
Try again with better quality
控制结构
Generate an image while maintaining the structure of the reference image
设置
元数据日志记录
服务器可以保存图像生成请求中的元数据,以帮助跟踪和排除故障。
| 环境变量 | 描述 | 必填 | 默认值 |
|---|---|---|---|
SAVE_METADATA | 保存元数据以成功生成图像 | N | true |
SAVE_METADATA_FAILED | 保存失败图像生成的元数据 | N | false |
当启用时,a .txt 将在同一目录中创建与生成的图像同名的文件。此文件包含:
- 请求的时间戳
- 所有请求参数(提示、型号、样式预设等)
- 响应信息(成功状态、生成时间)
如果出现以下情况,也将为失败的请求创建此文件 SAVE_METADATA_FAILED 已启用。
速查表
| 环境变量 | 说明 | 必填 | 默认值 | 示例 |
|---|---|---|---|---|
STABILITY_AI_API_KEY | 您的Stability AI API密钥。得到一个在 平台稳定性.ai | Y | N/A | sk-1234567890 |
IMAGE_STORAGE_DIRECTORY | 保存生成图像的目录 | N | /tmp/tadasant-mcp-tatttyai 或 C:\\Windows\\Temp\\mcp-tatttyai | /Users/admin/Downloads/stability-ai-images (Mac OS/Linux), C:\\Users\\Admin\\Downloads\\stability-ai-images (Windows) |
SAVE_METADATA | 保存元数据以成功生成图像 | N | true | true 或 false |
SAVE_METADATA_FAILED | 保存失败图像生成的元数据 | N | true | true 或 false |
GCS_PROJECT_ID | 用于存储图像的Google Cloud项目ID | N(如果使用SSE,则为Y) | N/A | your-project-id |
GCS_CLIENT_EMAIL | 用于存储图像的Google云服务帐户客户端电子邮件 | N(如果使用SSE,则为Y) | N/A | your-service-account@project.iam.gserviceaccount.com |
GCS_PRIVATE_KEY | 用于存储图像的Google云服务帐户私钥 | N(如果使用SSE,则为Y) | N/A | -----BEGIN PRIVATE KEY-----\nYourKeyHere\n-----END PRIVATE KEY-----\n |
GCS_BUCKET_NAME | 用于存储图像的Google Cloud Storage存储桶名称 | N(如果使用SSE,则为Y) | N/A | your-bucket-name |
克劳德桌面
如果你喜欢视频教程,这里 快速的.
在计算机上的某个位置创建一个文件夹目录来存储生成/修改的图像。一些选项:
/Users//Downloads/stability-ai-images/Users//Library/Application Support/Claude/mcp-tatttyai/images
确保你有一个 来自Stability AI的API密钥.
手动设置
你需要Node在你的机器上工作,这样你才能运行 npx 您终端中的命令。如果你没有Node,你可以从以下位置安装它 .
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
窗户: %APPDATA%\Claude\claude_desktop_config.json
修改您的 claude_desktop_config.json 文件以添加以下内容:
{
"mcpServers": {
"stability-ai": {
"command": "npx",
"args": [
"-y",
"mcp-tatttyai"
],
"env": {
"STABILITY_AI_API_KEY": "sk-1234567890"
}
}
}
}重新启动Claude Desktop,您应该已经准备好了:
SSE模式
此服务器可以通过以下命令启动以SSE模式运行:
npx mcp-tatttyai -y --sse如果您打算通过HTTP部署此服务器供第三方使用,则此模式非常有用。
您需要设置 GCS_PROJECT_ID, GCS_CLIENT_EMAIL, GCS_BUCKET_NAME,以及 GCS_PRIVATE_KEY 环境变量,因为服务器将图像文件存储在Google Cloud Storage中,而不是其本地文件系统中。
请注意,多租户方案非常幼稚和不安全:它使用请求者的IP地址来分割用于存储图像的GCS前缀,并使所有图像可公开访问,以便将它们传回MCP客户端。因此,理论上,如果有人知道你的IP地址,然后知道你生成的文件的名称,他们可以通过猜测URL来访问你的图像。
路线图
最近完成:
- ✅ 增加了对Stable Diffusion 3.5型号的支持
- ✅ 添加了对Stable Image Ultra的支持
- ✅ 为图像生成请求添加了元数据日志记录
这些很快就会到来;但欢迎公关!看 贡献.md.
inpaint-更精确的版本search-and-x功能,需要将掩码定义为要替换的区域。- 基础图像操作(裁剪、旋转、调整大小等):可能作为其自己的MCP服务器
- 能够将一个图像输入到另一个图像中。使用稳定性API似乎不可能;可能会希望另一个MCP服务器使用不同的API来实现这一点。
- 为图像处理定制的MCP客户端
贡献
欢迎外部捐款!看 贡献.md 了解更多详情。
也请随时提出问题或功能请求;喜欢看到人们如何使用它,以及如何让它变得更好。
