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

Большинство рабочих процессов ИИ терпят неудачу на последнем этапе: агент понимает форму, но не может записать в нее данные. 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 — аналогичный шаблон конфигурации

  • Любой агент, поддерживающий протокол 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

Участие в разработке и безопасность

  • CONTRIBUTING.md — настройка среды разработки и правила оформления PR

  • SECURITY.md — политика ответственного раскрытия информации

Лицензия

MIT — Copyright © 2025 Plenitudo AI


Related MCP Connectors

Related MCP Servers