PNPC-MCP-Tally-Prime

Model Context Protocol (MCP) サーバー。Claude が TallyPrime の内蔵 XML/HTTP ゲートウェイを介して読み書きを行えるようにします。

このプロジェクトは PNPC 内部使用のために vaijaaaaa/Tally-MCP-Server（ISC ライセンス）からフォークされました。原著作者の表示については LICENSE を参照してください。

仕組み

Claude Desktop  <--stdio-->   ┐
                               ├─ this MCP server  <--HTTP/XML-->  TallyPrime (localhost:9000)
Remote MCP client <--HTTP-->  ┘

ローカル環境では、Claude Desktop がこのサーバーを stdio プロセスとして起動します。リモート環境では、HTTP サーバーとしても実行できます。どちらの場合でも、ツール呼び出しは Tally の XML リクエスト形式に変換され、Tally の HTTP ゲートウェイに送信され、整形された JSON として返されます。また、固定のレポートツールを超えたアドホックなクエリのために、オプションのローカル SQL キャッシュ（PGLite）もあります。

前提条件

• Node.js 18 以上

• TallyPrime がインストールされ、実行中で、会社が開いていること

• Tally の HTTP ゲートウェイが有効になっていること: F1 (ヘルプ) > 設定 > 接続 > クライアント/サーバー設定 で TallyPrime の動作 を 両方 または サーバー、ポート 9000（デフォルト）に設定します。

セットアップ

npm install
npm run build

Claude Desktop の設定

オプション A — 拡張機能（推奨）： .dxt としてパッケージ化し、ワンクリックでインストールします。docs/EXTENSION_PACKAGING.md を参照してください。

オプション B — 手動設定： Claude Desktop の設定ファイルを編集します:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

以下を追加:

{
  "mcpServers": {
    "pnpc-tally": {
      "command": "C:\\Users\\Lokesh\\node20\\node.exe",
      "args": ["C:\\Users\\Lokesh\\PNPC-MCP-Tally-Prime\\dist\\index.js"],
      "env": {
        "TALLY_URL": "http://localhost:9000"
      }
    }
  }
}

Claude Desktop を再起動します。ハンマー/ツールアイコンが表示され、pnpc-tally サーバーが接続されたことを示します。

利用可能なツール

合計 17 ツール — 読み取り（元帳、在庫、グループ、伝票タイプ、原価センター、日計表、元帳伝票、会社情報、P&L、貸借対照表、試算表、在庫サマリー、受取手形/支払手形）、書き込み（元帳作成、グループ作成、在庫アイテム作成、伝票作成）、および SQL キャッシュ（sync_to_sql、query_sql）。引数を含む完全なリファレンス: docs/TOOLS.md。

日付は Tally の表記に合わせて DD-MM-YYYY 形式を使用します。

リモート実行（HTTP）

TALLY_MCP_TOKEN=<secret> npm run start:http

docs/HTTP_DEPLOYMENT.md を参照してください。

ドキュメント

• docs/ARCHITECTURE.md — リクエストフロー、ファイルの責務

• docs/TALLY_XML_GUIDE.md — Tally の XML ゲートウェイの仕組み、注意点

• docs/TOOLS.md — 全ツールリファレンス + 新しいツールの追加方法

• docs/SQL_CACHE.md — PGLite SQL キャッシュ、スキーマ、例

• docs/HTTP_DEPLOYMENT.md — リモート HTTP サーバーとしての実行

• docs/EXTENSION_PACKAGING.md — .dxt Claude Desktop 拡張機能としてのパッケージ化

プロジェクト構造

src/
  tally.ts        Tally HTTP client: sends XML, handles connection/timeout errors
  clean.ts        Normalizes Tally's raw XML->JSON into predictable JSON
  templates.ts     Renders the Nunjucks XML templates in templates/
  db.ts             PGLite SQL cache: sync_to_sql / query_sql
  tools.ts        MCP tool definitions + XML request builders
  server.ts       Shared MCP Server construction (used by both entry points)
  index.ts        stdio entry point (local Claude Desktop)
  http-server.ts   HTTP entry point (remote clients)
templates/
  *.xml.njk       Nunjucks templates for each Tally XML request shape
manifest.json      Claude Desktop Extension (.dxt) manifest

環境変数

トラブルシューティング