ต้นแบบ · รุ่นทดลอง: มีทุก server ในทะเบียนทางการ อัปเดตทุก 30 นาที เข้าสู่ระบบด้วย Google เพื่อเขียนรีวิวได้แล้วต้นแบบ · อัปเดตทุก 30 นาที
PopNx MCPที่รวม MCP สำหรับคนใช้ AI · วิธีติดตั้งภาษาไทยทุกตัว

Keiri Files (Japanese receipt filer)

โดย respectbarristerk-techรุ่น 0.4.1i★ 0iรันบนเครื่องหน้า repo ↗
ชื่อใน registryio.github.respectbarristerk-tech/keiri-files-mcp

วิธีติดตั้ง

ใช้ทำอะไรได้

ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ

  • ต่อแบบ ติดตั้งในเครื่อง
  • บัญชีหรือคีย์ ไม่ต้องใส่คีย์
  • หมวด เอกสาร ตาราง และงานออฟฟิศ
คำอธิบายต้นฉบับจากผู้ทำ (อังกฤษ)
Local-only MCP for Japanese receipts: rename by rule, CSV ledger, review queue, freee CSV export.

ใช้คู่กับ

Skill ที่สอน AI ทำงานแบบนี้ ใช้ร่วมกับตัวนี้ได้

MinerU

MinerU ใช้แปลงเอกสารที่ซับซ้อน เช่น PDF และไฟล์ Office ให้เป็นรูปแบบ markdown หรือ JSON ที่ LLM นำไปใช้ต่อได้ เหมาะสำหรับ workflow แบบ Agentic

โดย opendatalab★ 83,9191 skill

Skill · คู่มือไม่ระบุสัญญาอนุญาต

watermarks-remover

watermarks-remover เป็นแอปที่เน้นความเป็นส่วนตัว ใช้สำหรับลบลายน้ำ AI ออกจากเนื้อหาที่ผู้ใช้เป็นเจ้าของ

โดย guillaumemeyer★ 27,7231 skill

Skill · คู่มือ

obsidian-skills

obsidian-skills คือชุดทักษะสำหรับ AI เพื่อให้ใช้งาน Obsidian CLI และรูปแบบไฟล์ของ Obsidian ได้ เช่น Markdown, Bases และ JSON Canvas

โดย kepano★ 53,104 (ของทั้งรีโป)5 skill

Skill · คู่มือ

ทำไมอยู่อันดับนี้

หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้

ความนิยม0/80ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20
ความสด12/12ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม
ระบบยังตอบ0/8endpoint บนคลาวด์ตอบตอนตรวจล่าสุด
คะแนนการใช้งาน12/100

คุณภาพ: ผลตรวจเบื้องต้นผ่าน 3/3 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ผลตรวจผ่าน 3/3 · ทำงานบนเครื่องคุณ

ขั้นแรก: คุณใช้ AI ตัวไหน

เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง

ต่อกับ Claude ได้ แต่ต้องเตรียมก่อน

ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ใช้ได้เฉพาะแอป Claude บนคอม (Windows หรือ Mac) ไม่ใช่บนเว็บหรือมือถือ

  1. ดาวน์โหลดไฟล์ติดตั้งของผู้ทำ

    ดาวน์โหลดไฟล์ .mcpb ของผู้ทำ

    ไฟล์ .mcpb มาจากผู้ทำโดยตรง เราไม่ได้แก้ไฟล์

  2. ดับเบิลคลิกไฟล์ แล้วกด Install ในแอป Claude บนคอม

  3. ลองเลย

    ใช้ 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) ไม่ใช่บนเว็บหรือมือถือ

ข · ตัวอื่นในหมวด เอกสาร ตาราง และงานออฟฟิศ ที่ต่อกับ ChatGPT ได้

เลือกจากตัวที่ใช้มากในหมวดเดียวกัน เฉพาะตัวที่ต่อด้วยที่อยู่ได้โดยไม่ต้องใส่คีย์

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 มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม

ดูโปรแกรมที่ใช้ MCP ทั้งหมด →

ค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง

ติดตรงไหน? ถามคนที่ใช้ Keiri Files (Japanese receipt filer) อยู่💬 พูดคุย →

สรุป

ดาวน์โหลดต่อสัปดาห์i
ไม่มียอดใน npm/PyPI
การเชื่อมต่อ
รันบนเครื่อง
รุ่นล่าสุดi
0.4.1
ส่งเข้า registryi
17 พ.ย. 2569
แก้โค้ดล่าสุดi
17 พ.ย. 2569
ผู้ทำ
respectbarristerk-tech
แพ็กเกจ
mcpb: …/keiri-files-mcp-0.4.1.mcpb
สถานะใน registry
ใช้งานอยู่

ใช้กับโปรแกรมไหนได้

ดูจากแบบการต่อของ 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 บนอินเทอร์เน็ต

ช่องโหว่ที่เปิดเผยแล้ว (OSV.dev)

ไม่ได้ตรวจ: ตรวจได้เฉพาะแพ็กเกจ npm และ PyPI ที่ระบุรุ่น

เราตรวจอะไรบ้าง → · JSON

ผู้ทำ: ขอให้ตรวจใหม่ หรือแจ้งข้อมูลผิด
สำหรับผู้ทำ: ติดป้ายใน README

ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้

[![แนะนำบน PopNx MCP](https://mcp.popnx.com/badge/respectbarristerk-tech-keiri-files-mcp.svg?lang=th)](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

โดย HeyPuterใช้กันมาก★ 44.2Kอัปเดต 5 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · puter.com

XcodeBuildMCP

ให้ AI จัดการโปรเจกต์ Xcode สั่ง build และใช้ iOS Simulator

โดย getsentryใช้กันมาก↓ 130.5K/สัปดาห์ ยอดของแพ็กเกจที่ใช้ร่วม★ 6.6Kอัปเดต 4 เดือนที่ผ่านมา

รันบนเครื่อง✓ เจ้าของบริการ · xcodebuildmcp.com

Vexa

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

โดย Vexa-aiใช้กันมาก★ 3Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · vexa.ai

Atlassian Rovo MCP Server

server ทางการของ Atlassian ให้ AI ค้นและจัดการงานใน Jira และเอกสารใน Confluence ต่อผ่านคลาวด์และล็อกอินแบบ OAuth

โดย atlassianกำลังโต★ 1.2Kอัปเดต 2 เดือนที่ผ่านมา

รันบนคลาวด์✓ เจ้าของบริการ · atlassian.com

Anki MCP Server

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

โดย ankimcpกำลังโต↓ 1.1K/สัปดาห์★ 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

ส่วนนี้คัดจาก 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が読み取った内容をもとに

  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.