gwozai
large picture of the cover

Telegraph-Image 图床 MCP 使用指南（Cursor）

Telegraph-Image 图床 MCP 使用指南

让 Cursor、Claude Desktop 等 AI 助手直接上传图片到图床，自动返回 URL 和 Markdown 语法。

这是什么

telegraph-image-mcp 是一个 MCP Server，封装了 Telegraph-Image 图床的上传接口。

你在对话里说「把这张图上传到图床」，AI 会调用 MCP 工具完成上传，并返回：

  • 图片直链 URL
  • 可直接粘贴的 Markdown：![alt](url)

无需本地安装，一行 npx 即可使用。

相关链接

类型 地址
npm 包 https://www.npmjs.com/package/telegraph-image-mcp
GitHub https://github.com/gwozai/telegraph-image-mcp
示例图床 https://img.gwozai.email
Telegraph-Image 原版 https://github.com/cf-pages/Telegraph-Image

快速开始

1. 配置 MCP

编辑 ~/.cursor/mcp.json，添加：

{
  "mcpServers": {
    "telegraph-image": {
      "command": "npx",
      "args": ["-y", "telegraph-image-mcp"],
      "env": {
        "TELEGRAPH_IMAGE_BASE_URL": "https://img.gwozai.email"
      }
    }
  }
}

Claude Desktop 的 claude_desktop_config.json 配置方式相同。

2. 重启客户端

保存配置后重启 Cursor（或 Claude Desktop），在 MCP 面板确认 telegraph-image 显示为已连接。

3. 对话中使用

示例提示词：

把 /path/to/screenshot.png 上传到图床

返回示例：

{
  "file": "/path/to/screenshot.png",
  "src": "/file/xxx.png",
  "url": "https://img.gwozai.email/file/xxx.png",
  "markdown": "![screenshot](https://img.gwozai.email/file/xxx.png)"
}

把 markdown 字段的内容直接贴进博客或文档即可。

MCP 工具说明

工具 说明
upload_image 上传单张图片/视频。参数：file_path（必填）、alt_text（可选）
upload_images 批量上传。参数：file_paths（路径数组）
get_image_host_info 查看当前图床地址和 API 说明

环境变量

变量 默认值 说明
TELEGRAPH_IMAGE_BASE_URL https://img.gwozai.email Telegraph-Image 图床地址

如果你自建了 Telegraph-Image 实例，把环境变量改成自己的域名即可，无需改代码。

图床 API（原理）

MCP 内部调用的上传接口：

POST {BASE_URL}/upload
Content-Type: multipart/form-data

字段名: file

成功响应：

[{"src": "/file/xxx.png"}]

完整访问地址：{BASE_URL}/file/xxx.png

也可以用 curl 手动上传：

curl -X POST "https://img.gwozai.email/upload" \
  -F "file=@/path/to/image.png;type=image/png"

本地开发（可选）

如果你想改源码或贡献代码：

git clone https://github.com/gwozai/telegraph-image-mcp.git
cd telegraph-image-mcp
npm install
npm run build
npm run dev
命令 说明
npm run build 编译 TypeScript
npm run dev 开发模式运行
npm start 运行编译后的 MCP Server

常见问题

MCP 面板显示未连接

  1. 确认 Node.js >= 18 已安装（node -v）
  2. 确认 mcp.json JSON 格式正确
  3. 重启 Cursor 后再看 MCP 面板

上传失败

  • 检查文件路径是否存在（支持 ~ 开头）
  • 确认图床地址可访问
  • 单文件大小不超过 Telegram Bot 限制（约 50MB）

换自己的图床

只需修改 TELEGRAPH_IMAGE_BASE_URL，指向你自建的 Telegraph-Image 域名。

项目结构

telegraph-image-mcp/
├── src/
│   ├── index.ts      # MCP 工具注册
│   └── upload.ts     # 上传逻辑
├── package.json
└── tsconfig.json

License

MIT

site logo

Hi,Friend

© 2026 gwozai