SME Copilot MCP Server

中小企業向け経営アクションレポート自動生成システム（SME Copilot）のバックエンドとなるMCPサーバーです。 法人番号APIへの依存をなくし、社名と所在地をもとにウェブ検索＋LLM要約で企業プロファイルを取得し、法令条文と地域統計を組み合わせてレポート生成に必要なデータを提供します。

機能 (Tools)

現在の設計で提供するMCPツールは以下の3つです（法人番号は任意項目）。

1. lookup_company: 社名・所在地をキーにウェブ検索＋LLM要約で企業プロファイルを取得（法人番号が見つかれば付与）。

   • 必要: 検索プロバイダのAPIキー（例: Bing Web Search / SerpAPI / OpenAIブラウジング）

   • 出力: 商号、所在地、法人格、法人番号（任意）、公式サイト、出典URL、取得日時

2. get_law_article: 法令名と条番号から条文テキストを取得。

   • APIキー不要（e-Gov法令検索API）

3. get_region_stats: 都道府県と産業分類コードから地域統計（事業所数、従業者数）を取得。

   • 必要: e-Stat API アプリケーションID

移行メモ: 旧ツール list_corporation（法人番号API依存）は廃止予定です。コードも順次 lookup_company に置き換えます。

セットアップ

1. 前提条件

• Node.js (v18以上推奨)

• npm

2. 依存関係のインストール

npm install

3. 環境変数の設定

.env にAPIキー・設定値を記述します。

# .env ファイルを作成（すでにある場合は編集）
touch .env

サンプル:

# 検索プロバイダ設定（bing | serpapi | openai など）
SEARCH_PROVIDER=bing
SEARCH_API_KEY=your_search_api_key_here

# e-Stat API (https://www.e-stat.go.jp/api/api-info/api-registration)
ESTAT_APP_ID=your_estat_app_id_here

# 任意: タイムゾーンや通知リードタイム
TZ=Asia/Tokyo
NOTIFY_BEFORE_DAYS=7

ビルドと実行

ビルド

TypeScriptをコンパイルします。

npm run build

実行 (Stdioモード)

MCPサーバーを起動します（通常はMCPクライアントから自動起動されます）。

npm start

Claude Desktop での利用方法

Claude Desktop の設定ファイル (~/Library/Application Support/Claude/claude_desktop_config.json) にサーバーを登録します。

/absolute/path/to/taxAI の部分を実際の絶対パスに置き換えてください。

{
  "mcpServers": {
    "sme-copilot": {
      "command": "node",
      "args": [
        "/absolute/path/to/taxAI/build/index.js"
      ],
      "env": {
        "SEARCH_PROVIDER": "bing",
        "SEARCH_API_KEY": "取得した検索APIキー",
        "ESTAT_APP_ID": "取得したAppID"
      }
    }
  }
}

env セクションでAPIキーを指定すれば、.env の代わりに環境変数を直接渡せます。

開発・テスト

動作確認スクリプト

主要ツールをまとめて呼び出すテストスクリプトを用意しています（test_script.ts）。検索APIキーと e-Stat AppID をセットした上で実行してください。

npm run build
npx ts-node test_script.ts

ディレクトリ構成

• src/index.ts: サーバーのエントリーポイント。MCPツールの定義とリクエスト振り分け。

• src/clients/: 外部APIクライアント。

  • LawApiClient.ts: 法令APIクライアント（XMLパース含む）

  • EStatClient.ts: e-Stat APIクライアント

  • SearchClient.ts（予定）: ウェブ検索プロバイダ用クライアント

• build/: コンパイル済みJavaScript

• test_script.ts: ツールの簡易動作確認

アーキテクチャ（mermaid）

flowchart LR
  U["ユーザー / Claude Desktop"] --> M["MCPクライアント (stdio)"] --> S["SME Copilot MCPサーバー"]

  S --> LC[企業プロファイル取得]
  S --> LA[法令条文取得]
  S --> RS[地域統計取得]

  LC --> WEB[(検索API)]
  LA --> LAW[(e-Gov法令API)]
  RS --> EST[(e-Stat統計API)]

  LC --> LLM[LLM要約]
  LA --> LLM
  RS --> LLM
  LLM --> OUT[(レポート出力)]

ユーザーフロー（MVP想定, mermaid）

flowchart TD
  U[社名と所在地を入力]
  C[MCPクライアント]
  S[企業プロファイル取得]
  L[法令条文取得]
  R[地域統計取得]
  A[LLMで統合]
  P[("テキスト/PDF出力")]

  U --> C
  C --> S
  S --> C
  C -->|候補を表示| U
  U -->|プロファイルを承認| C
  C --> L
  C --> R
  L --> A
  R --> A
  S --> A
  A --> P

注意事項

• 検索結果には誤情報が含まれる可能性があるため、出典URLを必ず提示し、ユーザー承認を前提に保存してください。

• 法令情報・統計情報は最新性を保証しません。免責を明記し、税務判断は専門家確認を前提としてください。