nexus-ja-data

A local MCP server that lets AI agents clean Japanese business data with fixed rules instead of guessing.

• Normalizes Japanese company names ((株) / ㈱ / 株式会社 / half-width kana), phone numbers, postal codes, emails, addresses and era dates (令和6年4月1日, R6.3.15 → 2024-04-01)
• Deduplicates Japanese customer lists (名寄せ). Flags similar-but-different companies (さくら商事 / さくら商会) for review instead of merging them
• Same input → same output. Returns the reason for each match
• Python standard library only. No network access. Data never leaves your machine
• MIT license

{ "mcpServers": { "nexus-ja-data": { "command": "python", "args": ["/path/to/nexus-ja-data/run_server.py"] } } }

Tools: ja_normalize_value, ja_same_company, ja_detect_column_types, ja_clean_and_dedupe_records. See llms.txt.

nexus-ja-data(日本語)

AIエージェントのための、日本語ビジネスデータ整形・名寄せの道具(MCPサーバー)。 ClaudeやChatGPTなどのAIに登録すると、AIが日本語の会社名・電話・住所・和暦を「推測」ではなく「決まったルール」で正確に直し、顧客名簿の重複をまとめられるようになる。

• Python標準ライブラリだけで動く(追加インストール不要)
• 外部通信なし。データはパソコンの外に出ない
• 名寄せ赤ペン(p004)と同じルール。JavaScript版と結果が一致することをテストで確認済み

AIが使える道具(4つ)

なぜAIに必要か

大きなAIでも、日本語の表記ゆれは毎回少しずつ違う直し方をしたり、「さくら商事」と「さくら商会」を同じ会社にしてしまったりする。この道具を使えば、同じ入力にいつも同じ答えを返し、判断の根拠(一致した条件・似ている度)も返す。

使い方(Claude Desktop の例)

設定ファイル claude_desktop_config.json に次を追加(パスは置いた場所に合わせる):

{
  "mcpServers": {
    "nexus-ja-data": {
      "command": "python",
      "args": ["-m", "nexus_ja.server"],
      "cwd": "C:\\Users\\あなた\\Documents\\nexus-ja-data"
    }
  }
}

cwd が使えないアプリでは "args": ["C:\\...\\nexus-ja-data\\run_server.py"] を指定する。

配布条件

MITライセンス(無料・商用利用可)。行数の制限なし。 人間が画面で使える同じルールの道具「名寄せ赤ペン」は BOOTH で販売中: https://nexus-tools.booth.pm/items/9051166

品質

• テスト11件(python -m unittest discover -s tests): 正規化の期待値、名寄せ、MCPとしての通し会話(初期化→一覧→呼び出し→エラー処理)、壊れた入力でも落ちない、外部通信コードなし、JavaScript版との一致
• 2026-10-27: 全件成功