프로토타입 · 미리 보기: 공식 레지스트리의 모든 서버를 담고 있으며 30분마다 동기화해요. Google로 로그인하면 리뷰를 쓸 수 있어요.프로토타입 · 30분마다 업데이트
PopNx MCPAI를 쓰는 사람을 위한 MCP 서버 · 쉬운 말로 설명해요

Keiri Files (Japanese receipt filer)

제작자: respectbarristerk-tech버전 0.4.1i★ 0i내 컴퓨터에서 실행저장소 ↗
레지스트리 이름io.github.respectbarristerk-tech/keiri-files-mcp

설치 방법

What it does

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

  • Connects 내 컴퓨터에서 실행
  • Account or key No key needed
  • Category 문서, 시트 및 사무 업무

함께 쓰기

이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다

MinerU

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

제작자: opendatalab★ 83,919skill 1개

Skill · 안내서라이선스 명시 없음

watermarks-remover

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

제작자: guillaumemeyer★ 27,723skill 1개

Skill · 안내서

obsidian-skills

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

제작자: kepano★ 53,104 (whole repo)skill 5개

Skill · 안내서

이 순위인 이유

목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다

인기0/80GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20
최신성12/1230일 안에 릴리스나 코드 변경이 있으면 만점
응답 중0/8마지막 점검 때 클라우드 엔드포인트가 응답
사용 점수12/100

품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

검사 3/3 통과 · 내 컴퓨터에서 실행돼요

먼저: 어떤 AI를 쓰시나요?

쓰는 앱을 고르면 아래에 단계가 나옵니다.

Claude에 연결할 수 있지만 먼저 준비가 필요해요

키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

  1. 제작자 설치 파일 내려받기

    제작자의 .mcpb 파일 다운로드

    .mcpb 파일은 제작자에게서 바로 온 것으로, 우리는 바꾸지 않았어요

  2. 파일을 두 번 클릭한 뒤 컴퓨터용 Claude 앱에서 Install 누르기

  3. 해 보기

    Keiri Files (Japanese receipt filer)을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐

    ✓ Claude가 Keiri Files (Japanese receipt filer)을 쓰고 있다고 하거나 답에 Keiri Files (Japanese receipt filer) 도구 이름이 나오면 연결된 거예요

메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요

ChatGPT는 아직 Keiri Files (Japanese receipt filer)에 연결할 수 없어요

Keiri Files (Japanese receipt filer)는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요

대신 이렇게 할 수 있어요

A · Keiri Files (Japanese receipt filer)에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

B · 문서, 시트 및 사무 업무에서 ChatGPT에 연결되는 다른 서버

같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요

Claude Code는 아직 Keiri Files (Japanese receipt filer)에 연결할 수 없어요

제작자가 컴퓨터용 Claude 앱 설치 파일만 제공해요

대신 이렇게 할 수 있어요

A · Keiri Files (Japanese receipt filer)에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

Cursor는 아직 Keiri Files (Japanese receipt filer)에 연결할 수 없어요

제작자가 컴퓨터용 Claude 앱 설치 파일만 제공해요

대신 이렇게 할 수 있어요

A · Keiri Files (Japanese receipt filer)에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

VS Code는 아직 Keiri Files (Japanese receipt filer)에 연결할 수 없어요

제작자가 컴퓨터용 Claude 앱 설치 파일만 제공해요

대신 이렇게 할 수 있어요

A · Keiri Files (Japanese receipt filer)에 연결되는 앱 쓰기

  • 키 필요 없음, 설치 필요 없음 · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요

Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요

MCP를 쓰는 앱 모두 보기 →

JSON 설정은 아래 “개발자용”에 있어요

막혔나요? Keiri Files (Japanese receipt filer)을 쓰는 사람에게 물어보세요💬 토론 →

한눈에 보기

주간 다운로드i
npm/PyPI에 없음
연결 방식
내 컴퓨터에서 실행
최신 버전i
0.4.1
레지스트리 공개i
2026년 11월 17일
코드 마지막 변경i
2026년 11월 17일
제작자
respectbarristerk-tech
패키지
mcpb: …/keiri-files-mcp-0.4.1.mcpb
레지스트리 상태
활성

어떤 앱에서 쓸 수 있나요

이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.

내 컴퓨터에서 실행하는 앱

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

모든 앱과 장단점 →

할 수 있는 일

내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.

기본 점검i

누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 19일 점검

  • ✓ 통과

    제작자와 저장소 일치

    레지스트리 이름이 GitHub 계정 respectbarristerk-tech 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

  • ✓ 통과

    계속 관리되고 있음

    코드 마지막 변경: 그저께

  • ✓ 통과

    라이선스 있음

    MIT 사용

  • – 해당 없음

    엔드포인트 응답

    내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요

  • – 해당 없음

    OAuth로 로그인

    내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요

  • … 아직 점검 안 함

    도구 설명에 숨겨진 지시 없음

    내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요

공개된 취약점 (OSV.dev)

확인 안 함: 버전이 있는 npm과 PyPI 패키지만 확인할 수 있습니다

우리가 확인하는 것 → · JSON

제작자: 재확인 요청 또는 잘못된 정보 신고
제작자용: README에 배지 달기

제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.

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

토론

질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.

아직 글이 없어요. 처음으로 질문하거나 공유해 보세요.

이곳의 글은 사용자가 쓴 것으로, PopNx 팀의 글이 아니에요.

로그인하고 글쓰기

사용자 리뷰

아직 리뷰가 없어요

로그인하고 리뷰 쓰기

문서, 시트 및 사무 업무 카테고리의 다른 서버와 비교i

  • 이 카테고리의 다른 서버 4126개 중 0%보다 스타가 많아요
  • 이 카테고리의 다른 서버 4126개 중 93%보다 최근에 레지스트리에 공개됐어요
  • 기본 점검 결과가 이 카테고리의 다른 서버 4126개 중 99%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

Keiri Files (Japanese receipt filer), 안전한가요?

해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 그저께 변경됐고, 최신 버전(0.4.1)은 그저께 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 MCPB도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

비슷하게 동작하는 다른 것

같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.

카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

Puter MCP

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

제작자: HeyPuter널리 사용됨★ 4.4만5개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · puter.com

XcodeBuildMCP

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

제작자: getsentry널리 사용됨↓ 13만/주 공유 패키지 수치★ 6.6천4개월 전 업데이트

내 컴퓨터에서 실행✓ 서비스 회사 · xcodebuildmcp.com

Vexa

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

제작자: Vexa-ai널리 사용됨★ 3천2개월 전 업데이트

클라우드에서 실행✓ 서비스 회사 · vexa.ai

Anki MCP Server

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

제작자: ankimcp성장 중↓ 1.1천/주★ 567지난달 업데이트

내 컴퓨터에서 실행✓ 서비스 회사 · ankimcp.ai
비슷한 항목과 비교
이 항목
Keiri Files (Japanese receipt filer)
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
실행 위치컴퓨터에 설치 필요클라우드에서 동작, 설치 불필요컴퓨터에 설치 필요클라우드에서 동작, 설치 불필요클라우드에서 동작, 설치 불필요컴퓨터에 설치 필요
키 필요아니요아니요아니요예아니요아니요
Claude에서 +로 추가아니요아니요아니요아니요예아니요
기본 점검3/34/43/32/44/43/3
라이선스MITAGPL-3.0MITApache-2.0Apache-2.0MIT
가격등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음등록 정보에 비용 없음

제작자의 README

README 열기

제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.

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.