FormFill MCP
Fill any PDF form from your AI agent — in a single tool call.
](https://smithery.ai/server/@knportal/formfill-mcp)  ](smithery.yaml) 
Tax forms · HR paperwork · Legal documents · Lease agreements · Insurance claims
If it has fillable fields, FormFill can fill it.
获取API密钥 · Smithery的观点 ·建造于 完整 AI
______________________________________________________________________
运作原理
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 1. Inspect │ │ 2. Fill │ │ 3. Done │
│ │ → │ │ → │ │
│ list_form_ │ │ fill_form │ │ Filled PDF │
│ fields │ │ │ │ saved to disk │
│ │ │ │ │ │
│ Returns every │ │ Writes values, │ │ Open in │
│ field name, │ │ saves output │ │ Preview or │
│ type & value │ │ file │ │ send anywhere │
└─────────────────┘ └─────────────────┘ └─────────────────┘大多数人工智能工作流程在最后一英里崩溃:代理 *理解* 形式,但不能 *写信给它*.FormFill通过三个专注的工具填补了这一空白。
______________________________________________________________________
工具
| 工具 | 说明 | 何时使用 |
|---|---|---|
list_form_fields | 返回每个可填写的字段——名称、类型和当前值 | 第一步:发现表单中的内容 |
fill_form | 用提供的字段值填写PDF并保存结果 | 标准表格(1-5页) |
fill_form_multipage | 与 fill_form,对于大型文档,逐页处理 | 复杂的多页表单(6+页) |
______________________________________________________________________
使用
任何MCP兼容主机:
- 克劳德桌面版 --添加到
claude_desktop_config.json - 光标 --MCP服务器配置
- 克莱恩 --相同的配置模式
- 继续 --相同的配置模式
- 支持模型上下文协议的任何代理
______________________________________________________________________
支持的表单类型
| 类别 | 示例 |
|---|---|
| 税务 | W-9、W-4、1040、附表C、州表格 |
| 人力资源 | I-9、入职信息包、福利登记、PTO |
| 法律 | 保密协议、租赁协议、合同、披露 |
| 保险 | 索赔表、注册申请 |
| 房地产 | 购买协议、租赁申请、披露 |
| 教育 | 入学、经济援助、成绩单 |
______________________________________________________________________
定价
| 级别 | 价格 | 每月填充 |
|---|---|---|
| 自由 | 0美元 | 50次填充 |
| 专业版 | 9.99美元/月 | 无限制 |
获取API密钥: 豁免申请
______________________________________________________________________
快速开始
1.获取API密钥
注册地址: 豁免申请 --免费套餐立即可用。
2.连接到克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"formfill": {
"command": "/Users/YOUR_USERNAME/Projects/formfill-mcp/venv/bin/python",
"args": ["/Users/YOUR_USERNAME/Projects/formfill-mcp/server.py"]
}
}
}重新启动克劳德桌面。你会看到🔨 工具图标——FormFill已连接。
3.填写您的第一张表格
List the fillable fields in /Users/me/Desktop/w9.pdf using API key ff_free_abc123Fill the form at /Users/me/Desktop/w9.pdf with:
name: Jane Smith
TIN: 12-3456789
address: 123 Main St, Austin TX 78701
Save to /Users/me/Desktop/w9_filled.pdf
API key: ff_free_abc123______________________________________________________________________
示例提示
W-9(税):
Fill the W-9 at ~/Desktop/fw9.pdf with my name "John Smith", SSN "123-45-6789",
address "456 Oak Ave, Boston MA 02101". Business type: Individual/sole proprietor.
Save to ~/Desktop/fw9_filled.pdf. API key: ff_free_abc123租赁申请:
Fill the rental application at ~/Desktop/rental_app.pdf with these values:
[paste field values]. Save to ~/Desktop/rental_filled.pdf. API key: ff_free_abc123多页合同:
Fill the 8-page NDA at ~/Desktop/nda.pdf. My name: Jane Smith, Company: Acme Corp,
Date: March 28 2026. Use fill_form_multipage. API key: ff_free_abc123______________________________________________________________________
响应格式
成功:
{
"ok": true,
"output_path": "/Users/me/forms/w9_filled.pdf",
"fields_filled": 12,
"invalid_fields": []
}错误:
{"ok": false, "error": "Invalid API key"}
{"ok": false, "error": "Usage limit reached. Upgrade at https://formfill.plenitudo.ai"}
{"ok": false, "error": "File not found: /Users/me/missing.pdf"}______________________________________________________________________
自我寄宿
git clone https://github.com/knportal/formfill-mcp.git
cd formfill-mcp
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python manage_keys.py create --tier free
python server.py
# → MCP server running on http://localhost:8000对于远程代理访问,请部署附带的Cloudflare Worker(worker.js).
______________________________________________________________________
建筑
server.py — MCP server (3 tools)
auth.py — API key validation + usage tracking (SQLite)
stripe_webhook.py — Stripe subscription webhook handler
worker.js — Cloudflare Worker (remote proxy)
manage_keys.py — Key management CLI
data/keys.db — API key store
data/usage.db — Monthly usage counters______________________________________________________________________
贡献与安全
许可证
麻省理工学院 --版权所有©2025 Plenitudo AI
______________________________________________________________________
formfill.plenitudo.ai · Issues · Plenitudo.ai
