Skip to main content
Glama
deenesjakoruzh
knportal

formfill-mcp

by knportal
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

License: MIT Version MCP

获取 API 密钥 · 在 Smithery 上查看 · 由 Plenitudo AI 构建

收录于： Smithery · Glama

工作原理

 ┌─────────────────┐        ┌─────────────────┐        ┌─────────────────┐
 │  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  │
 └─────────────────┘        └─────────────────┘        └─────────────────┘

大多数 AI 工作流在最后一步都会受阻：智能体能够理解表单，但无法写入表单。FormFill 通过三个核心工具弥补了这一差距。

Related MCP server: Parzley MCP Server

工具

工具

描述

使用场景

list_form_fields

返回所有可填写的字段 — 名称、类型和当前值

第一步：发现表单内容

fill_form

使用提供的字段值填写 PDF 并保存结果

标准表单（1–5 页）

fill_form_multipage

与 fill_form 相同，但针对大型文档逐页处理

复杂的多页表单（6 页以上）

兼容性

任何兼容 MCP 的主机：

  • Claude Desktop — 添加到 claude_desktop_config.json

  • Cursor — MCP 服务器配置

  • Cline — 相同的配置模式

  • Continue — 相同的配置模式

  • 任何支持模型上下文协议 (MCP) 的智能体

支持的表单类型

类别

示例

税务

W-9, W-4, 1040, Schedule C, 各州表格

人力资源

I-9, 入职材料, 福利登记, 带薪休假 (PTO)

法律

保密协议 (NDA), 租赁协议, 合同, 披露声明

保险

索赔表格, 登记申请

房地产

购房协议, 租赁申请, 披露声明

教育

入学申请, 经济援助, 成绩单

定价

层级

价格

每月填写次数

免费版

$0

50 次填写

专业版

$9.99 / 月

无限制

在 formfill.plenitudo.ai 获取您的 API 密钥

快速入门

1. 获取 API 密钥

在 formfill.plenitudo.ai 注册 — 立即提供免费层级。

2. 连接到 Claude Desktop

编辑 ~/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"]
    }
  }
}

重启 Claude Desktop。您将看到 🔨 工具图标 — FormFill 已连接。

3. 填写您的第一份表单

List the fillable fields in /Users/me/Desktop/w9.pdf using API key ff_free_abc123
Fill 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

贡献与安全

许可证

MIT — 版权所有 © 2025 Plenitudo AI

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Related MCP Connectors

Related MCP Servers