
Blank Files MCP
io.github.filearchitect由 GitHub 帳號 filearchitect 發布v1.0.1更新於 Nov 10, 2026
MCP server for listing and retrieving minimal valid blank files from blankfiles.com.
概覽
依類別與檔案類型列出並查詢 blankfiles.com 上的最小有效空白檔案,讓助理找到可下載的空白檔案。
- 可以做什麼
- 依類別、類型與數量上限篩選列出空白檔案
- 依副檔名列出目錄項目
- 依類別加副檔名精確查詢單一檔案
- 適用情境
- 當你需要某種格式的最小有效空白檔案(例如試算表或文件)來測試上傳、驗證檔案處理流程,或作為工作流程的起點,並希望助理協助找到對應的下載項目時使用。
- 執行需求
- 以本機 Node.js 程序執行(npm 套件 @filearchitect/blankfiles-mcp,stdio 傳輸)。需要連線至 blankfiles.com 的網路;可選環境變數 BLANKFILES_BASE_URL 可覆寫基底網址。未宣告任何身分驗證。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Blank Files MCP,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Blank Files Website
Laravel application that powers blankfiles.com. Browse and download minimal valid blank files by type and category. File data and assets are served from the filearchitect/blank-files repository via a configurable CDN.
Requirements
- PHP 8.2+
- Composer
- Node.js 18+ (for Vite frontend build)
Installation
Set CDN_URL in .env (see Configuration). Then build the frontend and run the app:
Or use Laravel Herd with a .test domain.
Configuration
Project structure
Deployment
On push to main, GitHub Actions:
- Builds the frontend (Vite) with
npm ciandnpm run build. - SCPs
public/build/to the Forge server. - Triggers a Laravel Forge deployment.
- Runs
php artisan optimize:clearon the server.
Required repository secrets:
FORGE_SSH_HOST— SSH host for the server.FORGE_SSH_USER— SSH user (e.g.forge).SSH_PRIVATE_KEY— Private key for SCP/SSH.FORGE_SERVER_ID— Forge server ID.FORGE_SITE_ID— Forge site ID.FORGE_API_KEY— Forge deploy token.
See .github/workflows/deploy.yml.
For developers and bots
Base URL
Production: https://blankfiles.com. HTML and JSON are available; use Accept: application/json where applicable.
Web routes
API routes (prefix api/v1)
Machine-friendly notes
- The canonical file catalog schema is defined in the blank-files repo:
files/files.json(keyfiles, array of{ type, url, category, package? }). - Download URLs: use the API
urlfield for direct CDN access, orGET /files/download/{category}/{type}for a same-origin download with a predictable filename. - Conditional requests are supported on API responses and sitemap (
ETag,Last-Modified). - Rate limits: public IP-based limits and optional API-key limits (
X-API-Key). - API usage analytics are logged to
storage/logs/api-usage-*.log(configurable channel). - Compatibility policy: API policy.
- Web landing analytics for growth pages are logged to
storage/logs/web-traffic-*.log.
Client snippets
Compatibility policy
- URL versioning is stable under
/api/v1/*. - Breaking changes require a new major API path version.
- Deprecated endpoints are kept for at least 90 days before removal.
- New fields may be added; clients should ignore unknown fields.
Related
- filearchitect/blank-files — Source of truth for the file list and blank file assets.
MCP server (for agent marketplaces/registries)
This repository now includes a minimal MCP server that exposes Blank Files as tool calls.
- Script:
scripts/mcp/blankfiles-mcp.mjs - Run:
npm run mcp:server - Optional env:
BLANKFILES_BASE_URL(default:https://blankfiles.com)
Available MCP tools:
list_blank_files— list files, optional filters (category,type,limit)files_by_type— list entries by extensionfile_by_category_type— deterministic single lookup by category + extension
Example local MCP client config entry:
Registry submission helpers:
- Template metadata:
scripts/mcp/registry/server.json.template - Publish checklist:
scripts/mcp/registry/PUBLISHING.md
Published package workspace:
packages/blankfiles-mcp(publish as@filearchitect/blankfiles-mcp)
OpenClaw skill (ClawHub discoverability)
This repository includes an OpenClaw-ready skill bundle:
- Skill path:
skills/blankfiles - Skill entry:
skills/blankfiles/SKILL.md - Publish guide:
skills/blankfiles/references/publish.md
Typical publish flow:
License
This project is licensed under the MIT License.
來源:README.md,提交 00d8852
工具
0版本歷史
1- v1.0.1最新Sep 16, 2026
評分
已滿足適用檢查項的 40%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
請在儲存庫或註冊中心條目中宣告授權條款。