ใช้ทำอะไรได้
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
- ต่อแบบ ติดตั้งในเครื่อง
- บัญชีหรือคีย์ ไม่ต้องใส่คีย์
- หมวด เอกสาร ตาราง และงานออฟฟิศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Local-only MCP for Japanese receipts: rename by rule, CSV ledger, review queue, freee CSV export.ใช้คู่กับ
Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้
watermarks-remover
watermarks-remover เป็นแอปที่เน้นความเป็นส่วนตัว ใช้สำหรับลบลายน้ำ AI ออกจากเนื้อหาที่ผู้ใช้เป็นเจ้าของ
obsidian-skills
obsidian-skills คือชุดทักษะสำหรับ AI เพื่อให้ใช้งาน Obsidian CLI และรูปแบบไฟล์ของ Obsidian ได้ เช่น Markdown, Bases และ JSON Canvas
ทำไมอยู่อันดับนี้
หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 0/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 0/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 12/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
ดาวน์โหลดไฟล์ติดตั้งของผู้ทำ
ไฟล์ .mcpb มาจากผู้ทำโดยตรง เราไม่ได้แก้ไฟล์
ดับเบิลคลิกไฟล์ แล้วกด Install ในแอป Claude บนคอม
ลองเลย
ใช้ Keiri Files (Japanese receipt filer) บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ Keiri Files (Japanese receipt filer) หรือมีชื่อเครื่องมือของ Keiri Files (Japanese receipt filer) ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ChatGPT ยังต่อ Keiri Files (Japanese receipt filer) ไม่ได้
Keiri Files (Japanese receipt filer) ต้องติดตั้งในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะตัวที่ทำงานบนเว็บ
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ Keiri Files (Japanese receipt filer) ได้
- ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
Claude Code ยังต่อ Keiri Files (Japanese receipt filer) ไม่ได้
ผู้ทำมีแต่ไฟล์ติดตั้งสำหรับแอป Claude บนคอม
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ Keiri Files (Japanese receipt filer) ได้
- ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
Cursor ยังต่อ Keiri Files (Japanese receipt filer) ไม่ได้
ผู้ทำมีแต่ไฟล์ติดตั้งสำหรับแอป Claude บนคอม
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ Keiri Files (Japanese receipt filer) ได้
- ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
VS Code ยังต่อ Keiri Files (Japanese receipt filer) ไม่ได้
ผู้ทำมีแต่ไฟล์ติดตั้งสำหรับแอป Claude บนคอม
คุณทำแบบนี้แทนได้
ก · ใช้แอปที่ต่อ Keiri Files (Japanese receipt filer) ได้
- ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
สรุป
ใช้กับโปรแกรมไหนได้
ดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
คู่มือที่เกี่ยวข้อง
ทำอะไรได้บ้าง
รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง
ผลตรวจเบื้องต้นi
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub respectbarristerk-tech ซึ่งเป็นเจ้าของ repo
- ✓ ผ่าน
ยังมีคนดูแล
มีการแก้โค้ดล่าสุด เมื่อวานซืน
- ✓ ผ่าน
มีสัญญาอนุญาต (license)
ใช้ MIT
- – ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
- … ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต
ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/respectbarristerk-tech-keiri-files-mcp)พูดคุย
ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
รีวิวจากผู้ใช้
ยังไม่มีรีวิว
เทียบกับตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศi
- ดาวมากกว่า 0% ของอีก 4110 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 93% ของอีก 4110 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 99% ของอีก 4110 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
Keiri Files (Japanese receipt filer) ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด เมื่อวานซืน และส่งรุ่นล่าสุด (0.4.1) เข้า registry เมื่อวานซืน
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี MCPB ในเครื่องด้วย
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
ตัวอื่นที่ทำงานคล้ายกัน
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Puter MCP
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP
ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator
Vexa
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Atlassian Rovo MCP Server
server ทางการของ Atlassian ให้ AI ค้นและจัดการงานใน Jira และเอกสารใน Confluence ต่อผ่านคลาวด์และล็อกอินแบบ OAuth
Anki MCP Server
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| ตัวนี้ Keiri Files (Japanese receipt filer) | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ต้องลงในเครื่อง |
| ต้องใส่คีย์ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ | ไม่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ใช่ | ไม่ |
| ผลตรวจเบื้องต้น | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| สัญญาอนุญาต | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ 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が読み取った内容をもとに
- 中身をAIに見せる(
read_file。写真・スキャンPDFは向きを直して読みやすい大きさの画像に、文字のあるPDFは埋め込みテキストに) - 規則的なファイル名
YYYYMMDD_取引先_金額_書類種別.拡張子へコピー(またはリネーム) - 台帳CSV(UTF-8 BOM付き、Excelでそのまま開ける)へ追記
- 日付・金額・取引先で検索
- 読めない・迷うものは推測で確定せず「確認待ち」に記録し、その場で聞くか、Muse(パーソナルAI)/メールで後から聞く(v0.4)
- 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)
scan_folderで一覧を出す- AIが各ファイルを開いて日付・取引先・金額・書類種別・登録番号を読む
- 読めない・迷うものは
pending_addで確認待ちに(あなたがチャットにいればその場で聞く。いなければquestion_writeで Muse 用の質問ファイル、またはメール) propose_namesで命名案を作り、利用者が確認・承認するapply_renamesで実行(既定はコピー)ledger_appendで台帳に追記(科目・支払方法などは利用者が決める)- 回答が来たら
answers_read→pending_resolveで反映し、確定した分を 4〜6 で台帳へ 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.