SME Copilot MCP Server

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

機能 (Tools)

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

lookup_company: 社名・所在地をキーにウェブ検索＋LLM要約で企業プロファイルを取得（法人番号が見つかれば付与）。
- 必要: 検索プロバイダのAPIキー（例: Bing Web Search / SerpAPI / OpenAIブラウジング）
- 出力: 商号、所在地、法人格、法人番号（任意）、公式サイト、出典URL、取得日時
get_law_article: 法令名と条番号から条文テキストを取得。
- APIキー不要（e-Gov法令検索API）
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