Skip to main content
Glama
softvoyagers

fakturka-api-mcp

by softvoyagers

Faktuj MCPサーバー

npm version Website API Status

**Faktuj**をClaude、Cursor、VS Code、およびMCP互換のAIアシスタントに統合しましょう。VAT請求書やプロフォーマインボイスの作成、NIP(納税者番号)による企業検索、NBP(ポーランド国立銀行)の為替レート確認、IBAN番号の検証など、すべてAIワークフローから実行可能です。KSeFコンプライアンス要件にも完全対応しています。

APIキーは不要です。永年無料。

クイックスタート

claude_desktop_config.jsonに追加してください:

{
  "mcpServers": {
    "faktuj": {
      "command": "npx",
      "args": ["-y", "faktuj-mcp"]
    }
  }
}

またはグローバルにインストール:

npm install -g faktuj-mcp

その後、設定に追加してください:

{
  "mcpServers": {
    "faktuj": {
      "command": "faktuj-mcp"
    }
  }
}

Related MCP server: mcp-ksef-pl

利用可能なツール

ツール

説明

generate_invoice

ポーランドのVAT請求書PDFを作成します。売り手、買い手、明細を含む完全な請求書JSONを渡します。請求書番号とbase64形式のPDFを返します。

generate_proforma

プロフォーマインボイスPDFを作成します。VAT請求書と同じスキーマです。請求書番号とbase64形式のPDFを返します。

preview_invoice

PDFを作成せずに請求書データをプレビューおよび検証します。検証済みのデータまたは検証エラーを返します。

lookup_nip

NIP(納税者番号)でポーランドの企業を検索します。会社名、住所、登録データを返します。

lookup_nbp_rate

指定された通貨と日付のNBP(ポーランド国立銀行)の為替レートを検索します。

validate_iban

IBAN番号を検証します。検証結果と、有効な場合は銀行の詳細を返します。

使用例

AIアシスタントに次のように尋ねてください:

  • 「ACME sp. z o.o. (NIP: 1234567890) から Beta S.A. 宛てに、コンサルティング10時間(時給200 PLN)のVAT請求書を作成して」

  • 「NIP 5263442510 の企業を検索して」

  • 「2026年3月20日のEUR/PLNの為替レートは?」

  • 「IBAN PL61109010140000071219812874 を検証して」

アーキテクチャ

AI Assistant <--stdio--> faktuj-mcp <--HTTPS--> faktuj.pl REST API

これは、Faktuj REST API上の軽量なstdio MCPトランスポート層です。MCPサーバーはツール呼び出しをHTTPリクエストに変換し、構造化されたレスポンスを返します。

設定

環境変数

デフォルト

説明

FAKTUJ_API_URL

https://faktuj.pl

Faktuj APIのベースURL

リソース

SoftVoyagersエコシステム

FaktujはSoftVoyagersオープンソースポートフォリオの一部です:

製品

説明

ウェブサイト

LinkMeta

無料のURLメタデータ抽出API

linkmeta.dev

PageShot

無料のスクリーンショット&ウェブページキャプチャAPI

pageshot.site

PDFSpark

無料のHTML/URLからPDFへの変換API

pdfspark.dev

OGForge

無料のOpen Graph画像生成API

ogforge.dev

LinkShrink

無料のプライバシー重視URL短縮API

linkshrink.dev

Faktuj

無料のポーランドVAT請求書ジェネレーター

faktuj.pl

QRMint

無料のスタイル付きQRコード生成&API

qrmint.dev

PageDrop

無料のインスタントHTMLホスティングAPI

pagedrop.dev

PismoSzyteNaMiarę

Darmowy generator pism urzędowych

pismoszytenamiare.pl

ライセンス

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    MCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.
    6
    45 npm
    2
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    Model Context Protocol (MCP) server for Polish Electronic Invoicing (KSeF / FA(2)). Provides tools to validate, generate, and explore API specifications for KSeF interoperability.
    10
    3
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for the Invapi E-Invoicing API, enabling conversion, validation, and extraction of invoices in UBL, CII, ZUGFeRD, Excel, and more.
    48 npm
    MIT