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 — 동일한 설정 패턴

  • Model Context Protocol을 지원하는 모든 에이전트

지원되는 양식 유형

카테고리

예시

세금

W-9, W-4, 1040, Schedule C, 주별 양식

인사

I-9, 온보딩 패킷, 복리후생 등록, PTO

법률

NDA, 임대 계약서, 계약서, 공개 동의서

보험

청구 양식, 가입 신청서

부동산

매매 계약서, 임대 신청서, 공개 동의서

교육

입학 신청, 학자금 지원, 성적 증명서

요금

등급

가격

월간 작성 횟수

무료

$0

50회

Pro

$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 — Copyright © 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