Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

Keiri Files (Japanese receipt filer)

von respectbarristerk-techVersion 0.4.1i★ 0iLäuft auf deinem ComputerRepository ↗
Name in der Registryio.github.respectbarristerk-tech/keiri-files-mcp

So installierst du es

What it does

Local-only MCP for Japanese receipts: rename by rule, CSV ledger, review queue, freee CSV export.

  • Connects Läuft auf deinem Computer
  • Account or key No key needed
  • Category Dokumente, Tabellen & Büroarbeit

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

von opendatalab★ 83.9191 Skills

Skill · AnleitungKeine Lizenz angegeben

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

von guillaumemeyer★ 27.7231 Skills

Skill · Anleitung

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

von kepano★ 53.104 (whole repo)5 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch0/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert12/100

Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

3/3 Prüfungen bestanden · Läuft auf deinem Computer

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude, aber erst etwas vorbereiten

Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

  1. Installationsdatei des Anbieters herunterladen

    Die .mcpb-Datei des Entwicklers herunterladen

    Die .mcpb-Datei kommt direkt vom Anbieter; wir ändern sie nicht

  2. Datei doppelklicken, dann in der Claude-Desktop-App Install klicken

  3. Ausprobieren

    Nutze Keiri Files (Japanese receipt filer) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es Keiri Files (Japanese receipt filer) nutzt, oder ein Werkzeug von Keiri Files (Japanese receipt filer) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann Keiri Files (Japanese receipt filer) noch nicht verbinden

Keiri Files (Japanese receipt filer) läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen

Das kannst du stattdessen tun

A · Eine App nutzen, die Keiri Files (Japanese receipt filer) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

B · Andere in Dokumente, Tabellen & Büroarbeit, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Claude Code kann Keiri Files (Japanese receipt filer) noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die Keiri Files (Japanese receipt filer) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Cursor kann Keiri Files (Japanese receipt filer) noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die Keiri Files (Japanese receipt filer) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

VS Code kann Keiri Files (Japanese receipt filer) noch nicht verbinden

Der Anbieter liefert nur ein Installationspaket für die Claude-Desktop-App

Das kannst du stattdessen tun

A · Eine App nutzen, die Keiri Files (Japanese receipt filer) verbinden kann

  • Kein Schlüssel, nichts zu installieren · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die Keiri Files (Japanese receipt filer) nutzen💬 Diskussion →

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Verbindung
Läuft auf deinem Computer
Neueste Versioni
0.4.1
In der Registry veröffentlichti
17. Nov. 2026
Code zuletzt geänderti
17. Nov. 2026
Entwickler
respectbarristerk-tech
Pakete
mcpb: …/keiri-files-mcp-0.4.1.mcpb
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto respectbarristerk-tech bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vorgestern

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • – Nicht zutreffend

    Endpunkt antwortet

    Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen

  • … Noch nicht geprüft

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Veröffentlichte Schwachstellen (OSV.dev)

Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/respectbarristerk-tech-keiri-files-mcp.svg)](https://mcp.popnx.com/en/servers/respectbarristerk-tech-keiri-files-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Dokumente, Tabellen & Büroarbeiti

  • Mehr Sterne als 0 % der anderen 4110 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 93 % der anderen 4110 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 4110 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Keiri Files (Japanese receipt filer) sicher?

Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vorgestern geändert, und die neueste Version (0.4.1) kam vorgestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du MCPB auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

von HeyPuterWeit verbreitet★ 44.198Aktualisiert vor 5 Monaten

Läuft in der Cloud✓ vom Dienst · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

von getsentryWeit verbreitet↓ 130.486/Wo. geteiltes Paket★ 6585Aktualisiert vor 4 Monaten

Läuft auf deinem Computer✓ vom Dienst · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

von Vexa-aiWeit verbreitet★ 2994Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · vexa.ai

Atlassian Rovo MCP Server

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

von atlassianWachsend★ 1174Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · atlassian.com

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

von ankimcpWachsend↓ 1136/Wo.★ 567Aktualisiert letzten Monat

Läuft auf deinem Computer✓ vom Dienst · ankimcp.ai
Im Vergleich mit ähnlichen
Dieser
Keiri Files (Japanese receipt filer)
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Läuft woWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiert
Braucht SchlüsselNeinNeinNeinJaNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen3/34/43/32/44/43/3
LizenzMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

keiri-files-mcp(経理ファイル整理MCP)

AIに貼る導入プロンプト

次の文をそのままAI(Claude Code/Codex/Gemini CLI など、ファイル操作ができるAI)に貼ってください。

このリポジトリのREADMEとsrcを読んで、外部通信・削除・許可フォルダ外アクセスがないか要約してください。

問題なければ、私の環境(Claude Desktop/Claude Code/Codex 等)に合う導入手順を示し、私の承認を得てから実行してください。 許可フォルダには、レシート・請求書を置く専用のフォルダだけを指定してください。


PC内のレシート・請求書(PDF/画像)を、あなたのAIが読み取った内容をもとに

  1. 中身をAIに見せる(read_file。写真・スキャンPDFは向きを直して読みやすい大きさの画像に、文字のあるPDFは埋め込みテキストに)
  2. 規則的なファイル名 YYYYMMDD_取引先_金額_書類種別.拡張子 へコピー(またはリネーム)
  3. 台帳CSV(UTF-8 BOM付き、Excelでそのまま開ける)へ追記
  4. 日付・金額・取引先で検索
  5. 読めない・迷うものは推測で確定せず「確認待ち」に記録し、その場で聞くか、Muse(パーソナルAI)/メールで後から聞く(v0.4)
  6. freee の取引インポート用CSVを作る(v0.4。登録はしません)

するローカルMCPサーバーです。

  • 文字認識(OCR)はしません。read_file は画像やPDFのテキストをそのままAIに渡すだけで、読み取るのはあなたのAIです
  • 外部通信なし・削除なし・子プロセスの実行なし。メールも送りません(メールで知らせたい人は Claude の Gmail 連携を使います)。依存は公式MCP SDK・zod と、画像を読み書きする純JSのライブラリ jpeg-js・pngjs のみ(ネイティブ部品なし。SDKが内部で依存する express 等のパッケージも .mcpb に同梱されますが、このツールのコードからは使っておらず、通信用のサーバーも起動しません)
  • 許可したフォルダの外は読み書きしません(../ やシンボリックリンクでの脱出も拒否)
  • 書き込みを伴うツールは、AIクライアントの承認画面を通ります(ただし承認画面はクライアントの設定(自動承認など)によって出ないことがあります)
免責
  • ファイル名と一覧表を整える補助ツールです。電子帳簿保存法の要件を満たすことは保証しません。
  • 税務判断(勘定科目の確定、経費になるか等)はしません。読み取り結果と台帳の内容の確認は利用者の責任で行ってください。
  • 本ソフトウェアは現状のまま提供され、利用によって生じた損害について作者は責任を負いません(LICENSE 参照)。

撮影と知らせ方(v0.4)

  • 撮影の基本は Googleドライブアプリの「ドキュメントをスキャン」(Android・iPhone とも)。レシートの部分だけを自動で切り出してPDFにし、PCに同期した許可フォルダへ直接保存できます。写真(JPG)でも読めますが、うまく読めないときは「ドキュメントをスキャン」で撮り直しをお願いすることがあります(どのレシートか・撮影日時・読めた範囲を添えて知らせます)
  • 確認が必要な分の知らせ方は Muse(おすすめ)。Claude が notify_setup_text で表示する設定文を Muse に貼り付けるだけで、Muse が毎日決まった時刻に連絡用フォルダ 確認待ち/ の質問をまとめて伝え、あなたの返事を回答ファイルに保存します
  • メールで知らせてほしい場合(Gmail を使っている方)は、Claude の Gmail 連携で Claude が送ります。このツールにメールの送信機能はなく、パスワードも扱いません
  • Claude とチャットしているときは、通知を使わずその場で聞きます

ツール

ツール内容書き込み
scan_folder(subdir?, recursive?)PDF/JPG/PNG/HEIC の一覧(相対パス、サイズ、更新日時、台帳登録済みか)。最大500件。整理済み は対象外。recursive の既定は trueなし
read_file(path)証憑1件の中身を返す。JPG/PNG・文字のないPDF → 向きを直し縮めた MCP の image(縦長は重ねて複数枚)。文字のあるPDF → 埋め込みテキスト(下記)。HEIC は非対応(JPGに変換を案内)なし
propose_names(items[])命名案と形式エラー(日付・金額・登録番号・書類種別)を返し、plan_id を発行。同名は _2 等で回避。日付・取引先・金額が同じもの(同じ依頼内・台帳の既存行)は warnings に「重複の可能性」なし
apply_renames(plan_id, mode)plan_id の案だけ実行。既定 copy は 整理済み へコピー。rename は元ファイル名を変更(上書きなし)。整理済み/log.csv に記録あり
ledger_append(entries[], include_quotes?)整理済み/ledger.csv に追記。同じ証憑ファイル名、および実在しない証憑ファイル名(整理済み に無く、log.csv の copy/rename の記録先にも無いもの)は警告して追記しない。見積書は既定で追記しない(include_quotes: true で追記)。納品書は二重計上の注意つきで追記。日付・取引先・金額が同じ行は「重複の可能性」の警告つきで追記あり(追記のみ)
search_ledger(date_from?, date_to?, amount_min?, amount_max?, vendor?)条件を組み合わせて検索。件数・合計金額・該当行なし
pending_add(items[])読めない・迷うものを台帳に入れず 整理済み/確認待ち.csv に記録(R0001〜)。理由: 読み取り/撮り直し/私用の可能性/重複の可能性/科目/医療関係/その他。撮り直しは撮影日時と「ドキュメントをスキャン」の案内を質問に入れる。医療関係は名前を伏せ、画像を 整理済み/医療関係/R0001.jpg へ移す。カード番号らしきものが入っていると記録しない(ledger_append も同じ。v0.4.1)。医療関係の回答(pending_resolve の answer)は確認待ち.csv に原文のまま残るので、医療機関名などを書かないあり
pending_list(include_resolved?, for_notification?, today?)確認待ちの一覧。通知用は古い順に5件まで(残りは件数)、7日以上の件数、14日以上は月曜だけ。Gmail で送るときの文面の案も返すなし
pending_resolve(receipt_id, status, answer, new_question?, replaced_by?)回答を反映(確定/私用/重複/対象外/聞き直し(_2 まで)/チャットで確認)。回答の原文を残し、質問ファイルの状態も更新。解決済みには二重に反映しないあり
question_write(receipt_ids?)確認待ちを Muse が読む 確認待ち/question_R0001.txt にする。同じ質問は作り直さないあり
answers_read()Muse が保存した 確認待ち/answer_R0001.txt を読み、反映すべきか(反映済み・古い質問への回答など)を返すなし
notify_setup_text(method?, notify_time?, drive_folder?)Muse に貼り付ける設定文(既定)、または Gmail 連携の手順の案内を返すなし
export_freee(tax_label, accounts?, date_from?, date_to?)台帳から freee の取引インポート(収入・支出形式の支出)用CSVを 整理済み/freee出力/ に作る。税区分名は必須で全行に同じ名前(判断しない)。判断が要る行は freee_要確認.csv へ。出力済みは 整理済み/freee出力済み.csv に記録し次回は出さないあり
  • items の各要素: path, date(YYYY-MM-DD), vendor, amount(整数・円), doc_type(領収書/請求書/見積書/納品書/その他), invoice_no(任意、T+13桁)
  • 台帳の列: 日付, 支払先, 科目, 内容, 金額, 支払方法, インボイス有無, 登録番号, 証憑ファイル名, 事業割合(%), 書類種別, 元ファイル, 登録日時
  • インボイス有無は「あり」「なし」、事業割合は「50%」の形で書きます(Excel で開くと 0.5・パーセント表示として認識されます。未指定は空欄)。v0.3.0 までの「有」「無」の行もそのまま読み込み・重複判定に使えます
  • A〜J 列(日付〜事業割合)は、別売の台帳Excelにも貼れる並びです。台帳Excelへは A〜J 列(日付〜事業割合)だけをコピーして「経費」シートの5行目以降に値として貼ります。K列以降(書類種別・元ファイル・登録日時)は貼りません(台帳Excelの K列は台帳側の計算式です)
  • plan_id はサーバーのメモリ上にだけあり、再起動で消えます。1つの plan_id は1回だけ実行できます
  • 提案後に元ファイルが変更・移動された場合、その行は実行しません
  • 登録番号は形式(T+13桁)だけを確認します。実在の確認はしません
  • 「重複の可能性」は日付・取引先・金額が同じときに出す警告です(取引先は前後の空白と全角/半角の違いを無視して比較)。エラーにはせず、止めるかどうかは利用者とAIが決めます
  • 見積書は支払いの記録ではないため、ledger_append は既定で追記せず理由を警告で返します。台帳に入れたいときは include_quotes: true を指定します。納品書は同じ取引の請求書・領収書と二重計上になりうるため、追記したうえで注意を返します
  • 取引先が Windows の予約名(CON, PRN, AUX, NUL, COM1〜9, LPT1〜9)になる場合は、先頭に _ を付けます
  • rename モードで整理したファイルも、整理済み/log.csv の記録先に実在すれば ledger_append で追記できます(記録先から移動・名前変更すると警告になります)
read_file の返し方(v0.4: どの形式でも同じ下ごしらえ)
  • 写真(JPG/PNG): 撮影時の向き(EXIF の向き)を直し、長辺を 1568px までに縮めて JPEG で返します。スマホの写真(3〜6MB)もそのまま読めます(40MB まで)。小さく向きの正しい画像は元のまま返します
  • 縦長のもの(高さが幅の2.5倍を超える長いレシートなど): 幅を読みやすい大きさにしたうえで、上から複数枚(最大8枚)に分け、つなぎ目を少し重ねて返します。何枚中の何枚目かをテキストで添えます
  • 文字のないPDF(ドライブアプリの「ドキュメントをスキャン」など): PDF の中の JPEG を外部コマンドなしで取り出し、上と同じ処理をして画像で返します
  • 文字のあるPDF(パソコンで作った請求書など): 埋め込みテキストで返します。取り出しは依存を増やさない簡易版です(node:zlib のみ。FlateDecode・ASCII85・ASCIIHex、ToUnicode、オブジェクトストリームに対応)。配置は崩れることがあります
  • JPEG を取り出せないPDF・暗号化PDF: PDFファイルそのものを MCP の resource(blob、application/pdf)で返し、「ドキュメントをスキャン」での撮り直しを勧める文を添えます
  • 読めない・一部しか読めない写真は、推測で埋めず確認待ち(理由「撮り直し」)にします
フォルダ構成(例)
<許可フォルダ>/

受信/ ← レシート・請求書を置く 整理済み/ ← ツールが作る 20261001_架空商事テスト株式会社_55000_請求書.pdf ledger.csv ← 台帳 log.csv ← 実行ログ 確認待ち.csv ← 確認待ちの記録(v0.4) 医療関係/R0001.jpg ← 医療関係の領収書(名前を伏せて移したもの) freee出力/ ← freee 取り込み用CSV・要確認CSV freee出力済み.csv ← freee に出した行の記録 確認待ち/ ← Muse との連絡用(question_R0001.txt・answer_R0001.txt)

使い方の流れ(AI向けの手順は SKILL.md)

  1. scan_folder で一覧を出す
  2. AIが各ファイルを開いて日付・取引先・金額・書類種別・登録番号を読む
  3. 読めない・迷うものは pending_add で確認待ちに(あなたがチャットにいればその場で聞く。いなければ question_write で Muse 用の質問ファイル、またはメール)
  4. propose_names で命名案を作り、利用者が確認・承認する
  5. apply_renames で実行(既定はコピー)
  6. ledger_append で台帳に追記(科目・支払方法などは利用者が決める)
  7. 回答が来たら answers_read → pending_resolve で反映し、確定した分を 4〜6 で台帳へ
  8. search_ledger で確認。freee を使う人は export_freee

導入

必要なもの: Node.js 20 以上。

npm ci

npm run build npm test

起動は node dist/index.js <許可フォルダ> [<許可フォルダ2> ...] です。環境変数 KEIRI_ALLOWED_DIRS(Windows は ;、macOS/Linux は : 区切り)でも指定できます。以下の <...> は自分の絶対パスに置き換えてください。Windows のパスは / 区切りで書いても動きます。

Claude Desktop(.mcpb)

GitHub の Releases にある keiri-files-mcp-<版>.mcpb を使うか、自分で作ります。

npm ci

npm run build npm test npm run pack

`npm run pack`(scripts/pack-mcpb.mjs)は、一時フォルダに dist・manifest.json・README 等だけをコピーし、本番用の依存だけを入れて `keiri-files-mcp-<版>.mcpb` を作ります。開発用の依存(typescript、テスト用の架空証憑を作る pdfkit 等)は入りません。

できた .mcpb をダブルクリック(または Claude Desktop の設定画面にドラッグ)し、許可フォルダを選びます。v0.3.0 は Windows の Claude Desktop で導入と動作を確認済みです(macOS は未確認)。v0.4.0 は Linux 上のテストと .mcpb の起動確認まで(Windows の Claude Desktop での確認はこれから)。

Claude Code
claude mcp add keiri-files -- node <keiri-files-mcpの場所>/dist/index.js <許可フォルダ>

未確認(コマンドの形式は公式ドキュメントに基づく)。

Codex(~/.codex/config.toml)
[mcp_servers.keiri-files]

command = "node" args = [" /dist/index.js", "<許可フォルダ>"]

**未確認。**
Gemini CLI(~/.gemini/settings.json)
{

"mcpServers": { "keiri-files": { "command": "node", "args": [" /dist/index.js", "<許可フォルダ>"] } } }

**未確認。**

安全のための設計

  • パスは実パスに解決してから許可フォルダ配下かを判定します
  • 一覧ではシンボリックリンクをたどりません
  • コピーは既存ファイルを上書きしません(同名は _2 等)。リネームも上書きしません
  • 台帳CSVは = + - @ で始まる文字列の先頭に ' を付け、Excelで数式として実行されないようにしています
  • ソースは src/ の数ファイルだけです。AIに読ませて確認できます

開発

  • npm test: 単体テストと、SDKのMCPクライアントで架空の証憑10件を通す結合テスト(v0.2 の read_file・予約名・台帳の存在確認、v0.4 の画像の下ごしらえ・確認待ち・Muse・freee を含む)
  • node test/make_fixtures.mjs [日本語TTF] [欧文TTF]: テスト用の架空の証憑10件(日本語のレシート画像6件・テキスト入りPDF4件、test/fixtures/receipts)と印字内容 doc_texts.json を作り直す。社名・宛名はすべて架空、登録番号は先頭0の架空番号です。pdfkit・pureimage は開発用(devDependencies)で、.mcpb には入りません(jpeg-js・pngjs は v0.4 から本体でも使うため同梱)
  • node test/make_fixtures.mjs --v04 [日本語TTF] [欧文TTF]: v0.4 の read_file 用の架空ファイル3件(EXIF 向き=6 の JPG、縦長 JPEG 1枚だけの PDF、4MB 超の JPG)を test/fixtures/v04 に作る

English (summary)

A local MCP server that shows receipt/invoice contents to your AI (read_file: photos and scanned PDFs as upright, downscaled images — tall receipts split into overlapping pieces — and text PDFs as embedded text), renames/copies the files (PDF/JPG/PNG/HEIC) to YYYYMMDD_vendor_amount_type.ext and appends rows to an Excel-friendly CSV ledger, based on what your own AI client read from the documents. Since v0.4 it also keeps a "pending confirmation" list instead of guessing, writes question files for a personal AI (Muse) to relay, and exports a freee import CSV (no automatic registration). No OCR, no email sending, no network access, no deletion; it only touches the folders you allow. It is a helper for tidying file names and lists, not a guarantee of compliance with Japanese e-bookkeeping law, and it makes no tax decisions. License: MIT.