Skip to main content
Glama
knportal

formfill-mcp

by knportal

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は、3つの特化型ツールでそのギャップを埋めます。


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 — 同様の設定パターン

  • Model Context Protocolをサポートするあらゆるエージェント


対応フォームタイプ

カテゴリ

例

税務

W-9, W-4, 1040, Schedule C, 州フォーム

人事

I-9, オンボーディングパケット, 福利厚生登録, 有給休暇申請

法務

NDA, 賃貸契約書, 契約書, 開示書類

保険

保険金請求フォーム, 加入申込書

不動産

売買契約書, 賃貸申込書, 開示書類

教育

入学願書, 奨学金申請, 成績証明書


料金

プラン

価格

月間記入数

無料

$0

50件

Pro

$9.99 / 月

無制限

APIキーの取得はこちら: formfill.plenitudo.ai


クイックスタート

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 — Copyright © 2025 Plenitudo AI


Related MCP Connectors

Related MCP Servers