myra-1106

Kelivo File Maker MCP

Community myra-1106
Updated

Kelivo File Maker MCP

给 Kelivo 使用的远程 MCP 文件生成器。模型写完代码后,可以直接生成 .txt.html 或其他文本文件,并返回 HTTPS 下载链接。

已包含的工具

  • create_txt(filename, content):生成 TXT
  • create_html(filename, content):生成 HTML
  • create_pair(filename, content):用同一份源码同时生成 TXT + HTML
  • create_file(filename, content):生成 txt/html/htm/md/css/js/json/xml/csv/yaml/yml

默认文件保留 24 小时;每次生成使用随机 token,不会因为同名文件互相覆盖。

Render Web Service 的本地文件系统是临时的。服务重启或重新部署后,旧下载文件可能提前消失。因此这个 MCP 适合“模型生成后立即下载”,不是长期网盘。

1. 上传到 GitHub

  1. 解压本项目。
  2. 打开 GitHub,新建一个仓库,例如 kelivo-file-mcp
  3. 在仓库页面选择 Add file → Upload files
  4. 把本项目根目录里的文件和文件夹全部上传。
  5. Commit changes。

根目录应至少看到:

file_store.py
server.py
requirements.txt
render.yaml
README.md
KELIVO_SYSTEM_PROMPT.txt
tests/

2. 部署到 Render

推荐:Blueprint

  1. 登录 Render。
  2. 连接你的 GitHub。
  3. 选择 New → Blueprint
  4. 选择刚才的 kelivo-file-mcp 仓库。
  5. Render 会读取根目录的 render.yaml
  6. 确认后创建服务并等待部署完成。

本项目的 Render 配置已经写好:

  • Build Command:pip install -r requirements.txt
  • Start Command:uvicorn server:app --host 0.0.0.0 --port $PORT
  • Health Check:/health

如果不用 Blueprint

手动创建 Web Service,填写:

Language: Python 3
Build Command: pip install -r requirements.txt
Start Command: uvicorn server:app --host 0.0.0.0 --port $PORT
Health Check Path: /health

3. 确认服务器正常

Render 部署完成后会给你一个地址,例如:

https://kelivo-file-mcp.onrender.com

浏览器打开:

https://kelivo-file-mcp.onrender.com/health

正常会看到类似:

{
  "status": "ok",
  "service": "Kelivo File Maker MCP",
  "mcp": "/mcp",
  "ttl_hours": 24,
  "max_content_bytes": 3000000
}

4. 在 Kelivo 添加 MCP

MCP 类型选择 Streamable HTTP

地址填写:

https://你的Render地址.onrender.com/mcp

连接成功后,Kelivo 应能看到:

create_txt
create_html
create_pair
create_file

5. 给 Kelivo 加系统提示词

项目里已经准备好:

KELIVO_SYSTEM_PROMPT.txt

把里面的内容复制到你写代码的助手系统提示词中即可。

之后你可以直接说:

把这个代码改好,给我完整 TXT。

或:

改好后同时给我 HTML 和 TXT,两份源码必须完全一致。

模型就应该调用 MCP,而不是只在聊天框粘贴代码。

6. 文件保存规则

默认:

FILE_TTL_HOURS=24
MAX_CONTENT_BYTES=3000000

Render 会自动提供 RENDER_EXTERNAL_URL,代码使用它生成下载链接,所以通常不需要自己填写域名。

如果以后绑定自己的域名,可以在 Render 环境变量里加入:

PUBLIC_BASE_URL=https://你的域名

7. 本地测试(可选)

Python 3.10+:

pip install -r requirements-dev.txt
pytest -q
uvicorn server:app --host 127.0.0.1 --port 8000

打开:

http://127.0.0.1:8000/health

本地 MCP:

http://127.0.0.1:8000/mcp

为什么文件限制为 3 MB

MCP Streamable HTTP 默认请求体限制约为 4 MiB。给 content 保留协议封装余量后,本项目默认限制为 3,000,000 bytes,更适合直接生成代码和文本文件。

MCP Server · Populars

MCP Server · New