Shiwake MCP server

shiwake-mcp

仕訳データの一次スクリーニングを行う MCP サーバー。依存ライブラリはゼロ。

総勘定元帳から仕訳を受け取り、11個のルールを当てて、先に人間が目を通すべき順番に並べ替えて返します。監査の現場でいう仕訳テスト（Journal Entry Testing）を、AIエージェントから呼べる形にしたものです。

English

依存ライブラリを持たない理由

npm install で入るものが1つもありません。package.json の dependencies は空です。

会計データを扱う道具に外部依存を足すと、導入のたびに「このパッケージは何をしているのか」を説明する必要が出ます。監査法人や会計事務所のネットワークで動かすとき、その説明コストは実装の手間より高くつきます。依存がゼロなら、読むべきコードはこのリポジトリの中だけで閉じます。

MCP の stdio トランスポートは、行区切りの JSON-RPC 2.0 です。SDK を使わなくても 200 行ほどで書けます。

動かす

Node.js 20 以上が必要です。

MCP サーバーとして繋ぐ

npm に公開しているので、npx で起動できます。事前のインストールは要りません。ダウンロードされるのはこのパッケージ1つだけです。依存がないので、ほかには何も入りません。

Claude Code なら1行です。

claude mcp add shiwake -- npx -y shiwake-mcp

名前の前に --scope project を付けると、プロジェクト直下の .mcp.json に書き込まれ、チームで共有できます。

Claude Desktop は設定ファイル（claudedesktopconfig.json）に追記します。

{
  "mcpServers": {
    "shiwake": {
      "command": "npx",
      "args": ["-y", "shiwake-mcp"]
    }
  }
}

バージョンを固定したい場合は shiwake-mcp@0.1.0 のように指定します。コードを読んでから動かしたい場合は、リポジトリを clone して "command": "node"、"args": ["/path/to/shiwake-mcp/src/server.js"] と直接指定してください。

まず手元で試す

リポジトリを clone すると、同梱のサンプルデータ（合成データ383件、既知の異常を混ぜてあります）で挙動を確かめられます。npm install は要りません。

git clone https://github.com/USHIKUNDESUYO/shiwake-mcp.git
cd shiwake-mcp
npm run demo

検査対象   383 件
検出       53 件 / 対象仕訳 25 件
重要度     high 13 / medium 15 / low 25
ベンフォード  MAD 0.012241 → 許容の限界（n=383）

ルール別:
     営業時間外の入力                11 件
     キリのよい金額                   9 件
  !! 承認限度額の直下                 7 件
  !  重複仕訳                         5 件
  !! 起票者と承認者が同一             4 件
  !  期末直前の大口計上               4 件
  !  計上日と入力日の乖離             3 件
  !  稀な勘定科目の組み合わせ         3 件
     休日の計上                       3 件
  !! 貸借不一致                       2 件
     摘要が空                         2 件

確認の優先順位（上位 20 件）:
  [ 23] JV-0382    2025-09-06       3000000  self_approval, rare_account_pair, weekend_or_holiday, after_hours, round_amount, missing_description
  [ 19] JV-0365    2026-03-30       8900000  self_approval, period_end_large, after_hours, round_amount
        開発委託費
  [ 17] JV-0362    2026-01-22       1200000  unbalanced, rare_account_pair, round_amount
        業務委託費計上
  （以下省略）

383件が25件に絞られます。スコアは各ルールの重要度の合計で、複数のルールに同時に当たった仕訳ほど上に来ます。

ツール

入力の仕訳は、簡易形と明細形のどちらでも受けます。

{
  "id": "JV-0001",
  "date": "2026-03-31",
  "entered_at": "2026-04-02T23:41:00+09:00",
  "debit_account": "売掛金",
  "credit_account": "売上高",
  "amount": 12000000,
  "description": "3月度売上計上",
  "created_by": "acc01",
  "approved_by": "mgr01"
}

消費税や複合仕訳のように行数が増えるものは、明細形で渡します。

{
  "id": "JV-0002",
  "date": "2026-03-31",
  "lines": [
    { "account": "外注費", "debit": 1000000 },
    { "account": "仮払消費税", "debit": 100000 },
    { "account": "買掛金", "credit": 1100000 }
  ]
}

ルール

前提条件はオプションで渡します。

{
  "fiscalYearEnd": "03-31",
  "businessHours": [9, 18],
  "holidays": ["2026-01-01", "2026-01-12"],
  "approvalThresholds": [1000000, 5000000],
  "backdatedDaysThreshold": 30
}

Shortened. The full README is on GitHub.