# 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. 依存関係のインストール

```bash
npm install
```

### 3. 環境変数の設定

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

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

サンプル:

```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をコンパイルします。

```bash
npm run build
```

### 実行 (Stdioモード)
MCPサーバーを起動します（通常はMCPクライアントから自動起動されます）。

```bash
npm start
```

## Claude Desktop での利用方法

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

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

```json
{
  "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 をセットした上で実行してください。

```bash
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）

```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）

```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を必ず提示し、ユーザー承認を前提に保存してください。
- 法令情報・統計情報は最新性を保証しません。免責を明記し、税務判断は専門家確認を前提としてください。