Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Keiri Files (Japanese receipt filer)

de respectbarristerk-techversión 0.4.1i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.respectbarristerk-tech/keiri-files-mcp

Cómo instalar

What it does

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

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Documentos, hojas de cálculo y oficina

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

MinerU

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

de opendatalab★ 83.9191 skills

Skill · Guía de trabajoSin licencia indicada

watermarks-remover

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

de guillaumemeyer★ 27.7231 skills

Skill · Guía de trabajo

obsidian-skills

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

de kepano★ 53.104 (whole repo)5 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso12/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Descarga el instalador del autor

    Descargar el archivo .mcpb del creador

    El archivo .mcpb viene directo del autor; no lo modificamos

  2. Haz doble clic en el archivo y pulsa Install en la app de Claude de escritorio

  3. Pruébalo

    Usa Keiri Files (Japanese receipt filer) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Keiri Files (Japanese receipt filer) o muestra una herramienta de Keiri Files (Japanese receipt filer) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Keiri Files (Japanese receipt filer)

Keiri Files (Japanese receipt filer) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Keiri Files (Japanese receipt filer)

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

B · Otros en Documentos, hojas de cálculo y oficina que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Claude Code todavía no puede conectar Keiri Files (Japanese receipt filer)

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Keiri Files (Japanese receipt filer)

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Cursor todavía no puede conectar Keiri Files (Japanese receipt filer)

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Keiri Files (Japanese receipt filer)

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

VS Code todavía no puede conectar Keiri Files (Japanese receipt filer)

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Keiri Files (Japanese receipt filer)

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Keiri Files (Japanese receipt filer)💬 Conversación →

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en tu computadora
Última versióni
0.4.1
Publicado en el registroi
17 nov 2026
Último cambio de códigoi
17 nov 2026
Creador
respectbarristerk-tech
Paquetes
mcpb: …/keiri-files-mcp-0.4.1.mcpb
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub respectbarristerk-tech, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: anteayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

No revisado: solo se pueden revisar paquetes npm y PyPI con versión

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![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)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Documentos, hojas de cálculo y oficinai

  • Más estrellas que el 0% de los otros 4126 servidores de esta categoría
  • Publicado en el registro más recientemente que el 93% de los otros 4126 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 4126 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Keiri Files (Japanese receipt filer)?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez anteayer, y la última versión (0.4.1) llegó al registro anteayer.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas MCPB en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Puter MCP

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

de HeyPuterMuy usado★ 44,2 milActualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · puter.com

XcodeBuildMCP

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

de getsentryMuy usado↓ 130,5 mil/sem paquete compartido★ 6,6 milActualizado hace 4 meses

Se ejecuta en tu computadora✓ del servicio · xcodebuildmcp.com

Vexa

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

de Vexa-aiMuy usado★ 3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · vexa.ai

Atlassian Rovo MCP Server

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

de atlassianEn crecimiento★ 1,2 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · atlassian.com

Anki MCP Server

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

de ankimcpEn crecimiento↓ 1,1 mil/sem★ 567Actualizado el mes pasado

Se ejecuta en tu computadora✓ del servicio · ankimcp.ai
Comparado con otros parecidos
Este
Keiri Files (Japanese receipt filer)
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipo
Necesita claveNoNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoSíNo
Revisiones básicas3/34/43/32/44/43/3
LicenciaMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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.