bizgate-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,161 @@
+# bizgate-mcp-server
+
+BizGate API と Claude を接続する MCP サーバーです。
+会社名・法人番号で企業情報・部署・人事情報を検索し、Claude が自然言語で回答できるようにします。
+
+## 仕組み
+
+```
+[ユーザー] → [Claude] ←── MCP (stdio) ──→ [本サーバー] ──→ [BizGate API]
+```
+
+1. ユーザーが Claude に「○○の人事部の電話番号を教えて」と依頼
+2. Claude が MCP プロトコル経由で本サーバーのツールを呼び出す
+3. 本サーバーが BizGate API に問い合わせ → JSON レスポンスを解析
+4. 構造化された情報を Claude に返却
+5. Claude がユーザーに自然言語で回答（スプレッドシートへの入力も可能）
+
+## 提供ツール
+
+| ツール名 | 説明 | API消費 |
+|---------|------|--------|
+| `bizgate__company_search` | 企業の基本情報（住所・電話・代表者・業種・資本金 等） | 1回（結果なしでも課金） |
+| `bizgate__department_search` | 部署情報（部署名・住所・電話番号）最大500件 | 1回（データなしは課金なし） |
+| `bizgate__marketing_tags` | マーケティングタグ（SNS・MA・サービス・活動） | 1回（データなしは課金なし） |
+| `bizgate__keyman_search` | 人事情報（部署・役職・発令日）最大500件 | 1回（データなしは課金なし） |
+| `bizgate__company_full` | 企業＋部署＋人事を一括取得 | 3回 |
+| `bizgate__usage_status` | 本日の残りAPI回数を確認 | 0回 |
+
+## セットアップ
+
+### 前提条件
+
+- Node.js 18 以上
+- Claude Code がインストール済み
+- BizGate API のアカウント（ユーザー名・パスワード・サービスキー）
+
+### 1. リポジトリをクローン＆ビルド
+
+```bash
+git clone https://github.com/digiman-hq/bizgate-mcp-server.git
+cd bizgate-mcp-server
+npm install
+npm run build
+```
+
+### 2. Claude Code に MCP サーバーを登録
+
+以下のコマンドを **1行ずつ** 実行してください。サービスキーの値は管理者から受け取ってください。
+
+```bash
+claude mcp add --scope user bizgate \
+  --transport stdio \
+  -- node /path/to/bizgate-mcp-server/dist/index.js
+```
+
+> **注意**: 上記コマンドでは環境変数が設定されません。次のステップで手動設定が必要です。
+
+### 3. 環境変数を設定
+
+`~/.claude.json` を開き、`mcpServers.bizgate` の `env` セクションに以下を設定します。
+
+```json
+{
+  "mcpServers": {
+    "bizgate": {
+      "type": "stdio",
+      "command": "node",
+      "args": ["/path/to/bizgate-mcp-server/dist/index.js"],
+      "env": {
+        "BIZGATE_USERNAME": "あなたのユーザー名",
+        "BIZGATE_PASSWORD": "あなたのパスワード",
+        "BIZGATE_AUTH_MODE": "basic",
+        "BIZGATE_DAILY_LIMIT": "200",
+        "BIZGATE_SKEY_COMPANY": "企業APIのサービスキー",
+        "BIZGATE_SKEY_DEPARTMENT": "部署APIのサービスキー",
+        "BIZGATE_SKEY_MARKETING": "マーケAPIのサービスキー（任意）",
+        "BIZGATE_SKEY_KEYMAN": "キーマンAPIのサービスキー（任意）"
+      }
+    }
+  }
+}
+```
+
+> `/path/to/` はクローンした実際のパスに置き換えてください。
+
+### 4. Claude Code を再起動して確認
+
+```bash
+claude
+```
+
+起動後、`/mcp` コマンドで `bizgate` が **connected** になっていれば成功です。
+
+## 使い方
+
+Claude Code で自然言語で聞くだけです。
+
+### 基本的な使い方
+
+```
+エージェントの企業情報を教えて
+
+富士フイルムBIの営業部署を調べて
+
+GMOインターネットのマーケティングタグを教えて
+```
+
+### 部署の絞り込み
+
+```
+富士フイルムBIの東京都にある人事部を調べて
+
+トヨタ自動車の経理と総務の部署情報を教えて
+```
+
+### 一括取得
+
+```
+株式会社エージェントの全情報を調べて
+（→ 企業情報・部署・人事情報をまとめて取得）
+```
+
+### スプレッドシートとの連携
+
+```
+エージェントの企業情報を調べて、Excelに入力して
+
+このリストの会社の電話番号をスプレッドシートのB列に入れて
+```
+
+## 環境変数一覧
+
+| 変数名 | 必須 | 説明 |
+|-------|------|------|
+| `BIZGATE_USERNAME` | ○（basic認証時） | BizGate ユーザー名 |
+| `BIZGATE_PASSWORD` | ○（basic認証時） | BizGate パスワード |
+| `BIZGATE_AUTH_MODE` | | `basic`（デフォルト）または `ip` |
+| `BIZGATE_APP` | ○（IP認証時） | アプリ識別子 |
+| `BIZGATE_SKEY_COMPANY` | ○ | 企業APIのサービスキー |
+| `BIZGATE_SKEY_DEPARTMENT` | ○ | 部署APIのサービスキー |
+| `BIZGATE_SKEY_MARKETING` | | マーケティングタグAPIのサービスキー |
+| `BIZGATE_SKEY_KEYMAN` | | キーマンAPIのサービスキー |
+| `BIZGATE_DAILY_LIMIT` | | 1日のAPI上限（デフォルト: 200） |
+| `BIZGATE_BASE_URL` | | APIエンドポイント（通常変更不要） |
+
+## API利用上の注意
+
+- **企業検索は結果なしでも課金**されます。会社名は正確に入力してください
+- **部署・マーケ・キーマンはデータなしなら課金なし**です
+- 1日のAPI上限はエンリッチメントパイプラインと共有です（全体900回中、MCP用に200回を確保）
+- すべてのレスポンスに残りAPI回数が表示されます
+
+## トラブルシューティング
+
+| 症状 | 原因 | 対処法 |
+|------|------|--------|
+| `/mcp` で `failed` | 環境変数の設定ミス | `~/.claude.json` の env を確認 |
+| エラーコード 102 | サービスキーが無効 | 管理者に有効なサービスキーを確認 |
+| エラーコード 112 | 1日の上限超過 | 翌日まで待つ、または上限を確認 |
+| エラーコード 204 | 企業が見つからない | 正式名称（株式会社○○）で再検索 |
+| エラーコード 205 | 複数企業がマッチ | 法人番号やメールアドレスを追加で指定 |

package/dist/bizgate-client.d.ts

@@ -0,0 +1,68 @@
+import type { BizGateConfig, BizGateDoc } from "./types.js";
+import { UsageTracker } from "./usage-tracker.js";
+/** Extract first element from a string array field, or return empty string. */
+export declare function first(field: string[] | string | undefined): string;
+export declare class BizGateClient {
+    private config;
+    private usageTracker;
+    constructor(config: BizGateConfig, usageTracker: UsageTracker);
+    private buildUrl;
+    private getHeaders;
+    /** Send GET request and return parsed response. */
+    private request;
+    /**
+     * Company lookup (企業).
+     * Billed even on no-result — usage tracker is incremented BEFORE the call.
+     */
+    searchCompany(params: {
+        shogo?: string;
+        compno?: string;
+        hpurl?: string;
+        email?: string;
+        tel?: string;
+    }): Promise<{
+        matchPattern: string;
+        docs: BizGateDoc[];
+    }>;
+    /**
+     * Department lookup (部署).
+     * Not billed on failure, but we count conservatively.
+     */
+    searchDepartments(params: {
+        shogo?: string;
+        compno?: string;
+        pList?: string;
+        cList?: string;
+        bKwd?: string;
+        bKOpr?: string;
+    }): Promise<{
+        docs: BizGateDoc[];
+        numFound: number;
+    }>;
+    /**
+     * Marketing tags lookup (マーケティングタグ).
+     * Not billed on failure (company not found or no tags).
+     */
+    searchMarketingTags(params: {
+        shogo?: string;
+        compno?: string;
+    }): Promise<{
+        docs: BizGateDoc[];
+    }>;
+    /**
+     * Keyman lookup (キーマン・人名なし).
+     * Returns personnel records (department + title, announcement date, etc.).
+     * Not billed on failure.
+     */
+    searchKeyman(params: {
+        shogo?: string;
+        compno?: string;
+        pList?: string;
+        cList?: string;
+        bKwd?: string;
+        bKOpr?: string;
+    }): Promise<{
+        docs: BizGateDoc[];
+        numFound: number;
+    }>;
+}

package/dist/bizgate-client.js

@@ -0,0 +1,140 @@
+import { BizGateApiError, BIZGATE_ERROR_CODES } from "./types.js";
+/** Extract first element from a string array field, or return empty string. */
+export function first(field) {
+    if (Array.isArray(field))
+        return field[0] ?? "";
+    return field ?? "";
+}
+export class BizGateClient {
+    config;
+    usageTracker;
+    constructor(config, usageTracker) {
+        this.config = config;
+        this.usageTracker = usageTracker;
+    }
+    buildUrl(skey, params) {
+        const searchParams = new URLSearchParams({ skey, ...params });
+        if (this.config.authMode === "ip" && this.config.app) {
+            searchParams.set("app", this.config.app);
+        }
+        return `${this.config.baseUrl}?${searchParams.toString()}`;
+    }
+    getHeaders() {
+        if (this.config.authMode === "basic" &&
+            this.config.username &&
+            this.config.password) {
+            const encoded = Buffer.from(`${this.config.username}:${this.config.password}`).toString("base64");
+            return { Authorization: `Basic ${encoded}` };
+        }
+        return {};
+    }
+    /** Send GET request and return parsed response. */
+    async request(skey, params) {
+        const url = this.buildUrl(skey, params);
+        const response = await fetch(url, { headers: this.getHeaders() });
+        if (!response.ok) {
+            throw new BizGateApiError(String(response.status), `HTTP ${response.status}: ${response.statusText}`);
+        }
+        const json = (await response.json());
+        // Error response: status=999, error.code + error.msg
+        if (json.responseHeader.status === 999) {
+            const err = json.responseHeader.error;
+            const code = err?.code ?? "unknown";
+            const message = err?.msg ??
+                BIZGATE_ERROR_CODES[code] ??
+                `不明なエラー（コード: ${code}）`;
+            throw new BizGateApiError(code, message);
+        }
+        return json;
+    }
+    /**
+     * Company lookup (企業).
+     * Billed even on no-result — usage tracker is incremented BEFORE the call.
+     */
+    async searchCompany(params) {
+        this.usageTracker.increment();
+        const queryParams = {};
+        if (params.shogo)
+            queryParams.shogo = params.shogo;
+        if (params.compno)
+            queryParams.compno = params.compno;
+        if (params.hpurl)
+            queryParams.hpurl = params.hpurl;
+        if (params.email)
+            queryParams.email = params.email;
+        if (params.tel)
+            queryParams.tel = params.tel;
+        const result = await this.request(this.config.skeyCompany, queryParams);
+        return {
+            matchPattern: result.responseHeader.matchpatern ?? "",
+            docs: result.response?.docs ?? [],
+        };
+    }
+    /**
+     * Department lookup (部署).
+     * Not billed on failure, but we count conservatively.
+     */
+    async searchDepartments(params) {
+        this.usageTracker.increment();
+        const queryParams = {};
+        if (params.shogo)
+            queryParams.shogo = params.shogo;
+        if (params.compno)
+            queryParams.compno = params.compno;
+        if (params.pList)
+            queryParams.pList = params.pList;
+        if (params.cList)
+            queryParams.cList = params.cList;
+        if (params.bKwd)
+            queryParams.bKwd = params.bKwd;
+        if (params.bKOpr)
+            queryParams.bKOpr = params.bKOpr;
+        const result = await this.request(this.config.skeyDepartment, queryParams);
+        return {
+            docs: result.response?.docs ?? [],
+            numFound: result.response?.numFound ?? 0,
+        };
+    }
+    /**
+     * Marketing tags lookup (マーケティングタグ).
+     * Not billed on failure (company not found or no tags).
+     */
+    async searchMarketingTags(params) {
+        this.usageTracker.increment();
+        const queryParams = {};
+        if (params.shogo)
+            queryParams.shogo = params.shogo;
+        if (params.compno)
+            queryParams.compno = params.compno;
+        const result = await this.request(this.config.skeyMarketing, queryParams);
+        return {
+            docs: result.response?.docs ?? [],
+        };
+    }
+    /**
+     * Keyman lookup (キーマン・人名なし).
+     * Returns personnel records (department + title, announcement date, etc.).
+     * Not billed on failure.
+     */
+    async searchKeyman(params) {
+        this.usageTracker.increment();
+        const queryParams = {};
+        if (params.shogo)
+            queryParams.shogo = params.shogo;
+        if (params.compno)
+            queryParams.compno = params.compno;
+        if (params.pList)
+            queryParams.pList = params.pList;
+        if (params.cList)
+            queryParams.cList = params.cList;
+        if (params.bKwd)
+            queryParams.bKwd = params.bKwd;
+        if (params.bKOpr)
+            queryParams.bKOpr = params.bKOpr;
+        const result = await this.request(this.config.skeyKeyman, queryParams);
+        return {
+            docs: result.response?.docs ?? [],
+            numFound: result.response?.numFound ?? 0,
+        };
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,401 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { BizGateClient, first as f } from "./bizgate-client.js";
+import { BizGateApiError, DEPARTMENT_CATEGORIES } from "./types.js";
+import { UsageTracker } from "./usage-tracker.js";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// ---------- 環境変数読み込み ----------
+const skeyCompany = process.env.BIZGATE_SKEY_COMPANY;
+const skeyDepartment = process.env.BIZGATE_SKEY_DEPARTMENT;
+const skeyMarketing = process.env.BIZGATE_SKEY_MARKETING ?? "";
+const skeyKeyman = process.env.BIZGATE_SKEY_KEYMAN ?? "";
+if (!skeyCompany || !skeyDepartment) {
+    console.error("Error: BIZGATE_SKEY_COMPANY and BIZGATE_SKEY_DEPARTMENT environment variables are required");
+    process.exit(1);
+}
+const authMode = (process.env.BIZGATE_AUTH_MODE ?? "basic");
+if (authMode === "basic") {
+    if (!process.env.BIZGATE_USERNAME || !process.env.BIZGATE_PASSWORD) {
+        console.error("Error: BIZGATE_USERNAME and BIZGATE_PASSWORD are required when BIZGATE_AUTH_MODE=basic");
+        process.exit(1);
+    }
+}
+if (authMode === "ip" && !process.env.BIZGATE_APP) {
+    console.error("Error: BIZGATE_APP is required when BIZGATE_AUTH_MODE=ip");
+    process.exit(1);
+}
+const dailyLimit = Number(process.env.BIZGATE_DAILY_LIMIT ?? "200");
+const usageFile = process.env.BIZGATE_USAGE_FILE ??
+    join(homedir(), ".bizgate-mcp-usage.json");
+const baseUrl = process.env.BIZGATE_BASE_URL ??
+    "https://target.papatto.info/bizgate/dictionary.php";
+// ---------- クライアント初期化 ----------
+const config = {
+    baseUrl,
+    skeyCompany,
+    skeyDepartment,
+    skeyMarketing,
+    skeyKeyman,
+    authMode,
+    username: process.env.BIZGATE_USERNAME,
+    password: process.env.BIZGATE_PASSWORD,
+    app: process.env.BIZGATE_APP,
+    dailyLimit,
+};
+const usageTracker = new UsageTracker(usageFile, dailyLimit);
+const client = new BizGateClient(config, usageTracker);
+// ---------- MCPサーバー ----------
+const server = new McpServer({
+    name: "bizgate-mcp-server",
+    version: "0.3.0",
+});
+// ---------- ヘルパー ----------
+function usageFooter() {
+    const remaining = usageTracker.remaining();
+    const count = usageTracker.currentCount();
+    return `\n\n---\n残りAPI回数: ${remaining}回（本日使用: ${count}/${dailyLimit}）`;
+}
+function errorText(err) {
+    if (err instanceof BizGateApiError) {
+        return `エラー: ${err.message}（コード: ${err.code}）${usageFooter()}`;
+    }
+    if (err instanceof Error) {
+        return `エラー: ${err.message}`;
+    }
+    return "不明なエラーが発生しました";
+}
+function formatCompanyDoc(doc) {
+    const lines = [`## 企業情報: ${f(doc.shogo)}`];
+    if (doc.compno)
+        lines.push(`法人番号: ${doc.compno}`);
+    if (f(doc.zip))
+        lines.push(`郵便番号: ${f(doc.zip)}`);
+    if (f(doc.add))
+        lines.push(`住所: ${f(doc.add)}`);
+    if (f(doc.pref))
+        lines.push(`都道府県: ${f(doc.pref)}`);
+    if (f(doc.tel))
+        lines.push(`電話: ${f(doc.tel)}`);
+    if (f(doc.fax))
+        lines.push(`FAX: ${f(doc.fax)}`);
+    if (f(doc.mail))
+        lines.push(`メール: ${f(doc.mail)}`);
+    if (f(doc.ceo))
+        lines.push(`代表者: ${f(doc.ceo)}`);
+    if (f(doc.gyoshu_facet))
+        lines.push(`業種: ${f(doc.gyoshu_facet)}`);
+    if (doc.shihon)
+        lines.push(`資本金: ${doc.shihon}`);
+    if (doc.revenue)
+        lines.push(`売上: ${doc.revenue}`);
+    if (doc.emp)
+        lines.push(`従業員: ${doc.emp}`);
+    if (doc.pub)
+        lines.push(`上場区分: ${doc.pub}`);
+    if (f(doc.hpurl))
+        lines.push(`HP: ${f(doc.hpurl)}`);
+    if (doc.seturitu)
+        lines.push(`設立: ${doc.seturitu}`);
+    if (doc.kessanm)
+        lines.push(`決算月: ${doc.kessanm}`);
+    if (doc.invoiceno)
+        lines.push(`インボイス番号: ${doc.invoiceno}`);
+    if (f(doc.bumon))
+        lines.push(`拠点名: ${f(doc.bumon)}`);
+    return lines.join("\n");
+}
+function formatDepartmentDoc(doc, index) {
+    const deptName = f(doc.bumon) || "(不明)";
+    const lines = [`${index}. ${deptName}`];
+    if (f(doc.add))
+        lines.push(`   住所: ${f(doc.add)}`);
+    if (f(doc.tel))
+        lines.push(`   電話: ${f(doc.tel)}`);
+    if (f(doc.pref))
+        lines.push(`   都道府県: ${f(doc.pref)}`);
+    const categories = [];
+    for (const [key, label] of Object.entries(DEPARTMENT_CATEGORIES)) {
+        if (doc[key] === "true") {
+            categories.push(label);
+        }
+    }
+    if (categories.length > 0) {
+        lines.push(`   カテゴリ: ${categories.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+function formatKeymanDoc(doc, index) {
+    const role = f(doc.bumon) || "(不明)";
+    const lines = [`${index}. ${role}`];
+    if (doc.pagedate)
+        lines.push(`   発表日: ${doc.pagedate}`);
+    if (doc.haturei)
+        lines.push(`   発令日: ${doc.haturei}`);
+    if (doc.bikou)
+        lines.push(`   備考: ${doc.bikou}`);
+    if (doc.compno)
+        lines.push(`   法人番号: ${doc.compno}`);
+    const categories = [];
+    for (const [key, label] of Object.entries(DEPARTMENT_CATEGORIES)) {
+        if (doc[key] === "true") {
+            categories.push(label);
+        }
+    }
+    if (categories.length > 0) {
+        lines.push(`   カテゴリ: ${categories.join(", ")}`);
+    }
+    return lines.join("\n");
+}
+// ---------- 共通バリデーション ----------
+function validateInput(shogo, compno) {
+    if (!shogo && !compno) {
+        return "エラー: 会社名（shogo）または法人番号（compno）のいずれかを入力してください。";
+    }
+    if (compno && !/^\d{13}$/.test(compno)) {
+        return "エラー: 法人番号は13桁の数字で入力してください。";
+    }
+    return null;
+}
+// ---------- Tool 1: 企業検索 ----------
+server.tool("bizgate__company_search", "会社名または法人番号で企業の基本情報（住所・電話・FAX・代表者・業種・資本金・売上・HP）を検索する。1回の検索で課金されるため、会社名は正確に入力してください。", {
+    shogo: z.string().optional().describe("会社名（例：株式会社○○）"),
+    compno: z.string().optional().describe("法人番号（13桁）"),
+    hpurl: z.string().optional().describe("ホームページURL（マッチング精度向上）"),
+    email: z.string().optional().describe("メールアドレス（マッチング精度向上）"),
+    tel: z.string().optional().describe("電話番号（マッチング精度向上）"),
+}, async ({ shogo, compno, hpurl, email, tel }) => {
+    const err = validateInput(shogo, compno);
+    if (err)
+        return { content: [{ type: "text", text: err }] };
+    try {
+        const { matchPattern, docs } = await client.searchCompany({
+            shogo, compno, hpurl, email, tel,
+        });
+        if (docs.length === 0) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `該当する企業が見つかりませんでした。（マッチパターン: ${matchPattern}）${usageFooter()}`,
+                    }],
+            };
+        }
+        const text = docs.map(formatCompanyDoc).join("\n\n");
+        return {
+            content: [{ type: "text", text: text + `\nマッチパターン: ${matchPattern}${usageFooter()}` }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: errorText(e) }] };
+    }
+});
+// ---------- Tool 2: 部署検索 ----------
+server.tool("bizgate__department_search", "会社名または法人番号で部署情報（部署名・住所・電話番号・カテゴリ）を検索する。最大500件。都道府県・カテゴリ・部署名キーワードで絞り込み可能。", {
+    shogo: z.string().optional().describe("会社名（例：株式会社○○）"),
+    compno: z.string().optional().describe("法人番号（13桁）"),
+    pList: z.string().optional().describe("都道府県コード（カンマ区切り。例: 13,14 = 東京都,神奈川県）"),
+    cList: z.string().optional().describe("部署カテゴリ番号（カンマ区切り。1=経営企画,2=営業企画,3=人事,4=経理,5=総務,6=広報IR,7=法務,8=研究,9=購買,10=システム,11=海外,12=環境CSR,13=営業,14=製造工場,15=その他）"),
+    bKwd: z.string().optional().describe("部署名キーワード（カンマ区切りで複数可。例: 人事部,経理部）"),
+    bKOpr: z.string().optional().describe("キーワード結合演算子（0=OR（デフォルト）, 1=AND）"),
+}, async ({ shogo, compno, pList, cList, bKwd, bKOpr }) => {
+    const err = validateInput(shogo, compno);
+    if (err)
+        return { content: [{ type: "text", text: err }] };
+    try {
+        const { docs, numFound } = await client.searchDepartments({
+            shogo, compno, pList, cList, bKwd, bKOpr,
+        });
+        if (docs.length === 0) {
+            return {
+                content: [{ type: "text", text: `部署情報が見つかりませんでした。${usageFooter()}` }],
+            };
+        }
+        const companyName = f(docs[0].shogo);
+        const header = `## 部署情報${companyName ? `: ${companyName}` : ""}（全${numFound}件）\n`;
+        const text = docs.map((d, i) => formatDepartmentDoc(d, i + 1)).join("\n\n");
+        return {
+            content: [{ type: "text", text: header + text + usageFooter() }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: errorText(e) }] };
+    }
+});
+// ---------- Tool 3: マーケティングタグ ----------
+server.tool("bizgate__marketing_tags", "会社名または法人番号で企業のマーケティングタグ（SNS導入、MAツール、事業サービス、活動状況）を検索する。プロスペクトリストのフィルタリングや営業優先度判断に活用。課金なし（企業特定不可・タグなしの場合）。", {
+    shogo: z.string().optional().describe("会社名（例：株式会社○○）"),
+    compno: z.string().optional().describe("法人番号（13桁）"),
+}, async ({ shogo, compno }) => {
+    const err = validateInput(shogo, compno);
+    if (err)
+        return { content: [{ type: "text", text: err }] };
+    if (!skeyMarketing) {
+        return {
+            content: [{ type: "text", text: "エラー: BIZGATE_SKEY_MARKETING が設定されていません。" }],
+        };
+    }
+    try {
+        const { docs } = await client.searchMarketingTags({ shogo, compno });
+        if (docs.length === 0) {
+            return {
+                content: [{ type: "text", text: `マーケティングタグが見つかりませんでした。${usageFooter()}` }],
+            };
+        }
+        const doc = docs[0];
+        const lines = [`## マーケティングタグ: ${f(doc.shogo)}`];
+        if (doc.compno)
+            lines.push(`法人番号: ${doc.compno}`);
+        if (doc.snstag)
+            lines.push(`\n### SNSタグ\n${doc.snstag.replace(/¥\//g, "\n- ").replace(/^/, "- ")}`);
+        if (doc.matag)
+            lines.push(`\n### MAツール\n${doc.matag.replace(/¥\//g, "\n- ").replace(/^/, "- ")}`);
+        if (doc.servicetag)
+            lines.push(`\n### 事業サービス\n${doc.servicetag.replace(/¥\//g, "\n- ").replace(/^/, "- ")}`);
+        if (doc.activtag)
+            lines.push(`\n### 活動タグ\n${doc.activtag.replace(/¥\//g, "\n- ").replace(/^/, "- ")}`);
+        return {
+            content: [{ type: "text", text: lines.join("\n") + usageFooter() }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: errorText(e) }] };
+    }
+});
+// ---------- Tool 4: キーマン検索 ----------
+server.tool("bizgate__keyman_search", "会社名または法人番号で人事情報（部署・役職、発表日、発令日）を検索する。最大500件。部署カテゴリやキーワードで絞り込み可能。人名は含まれない。課金なし（企業特定不可・データなしの場合）。", {
+    shogo: z.string().optional().describe("会社名（例：株式会社○○）"),
+    compno: z.string().optional().describe("法人番号（13桁）"),
+    pList: z.string().optional().describe("都道府県コード（カンマ区切り）"),
+    cList: z.string().optional().describe("部署カテゴリ番号（カンマ区切り。3=人事,13=営業 など）"),
+    bKwd: z.string().optional().describe("部署・役職キーワード（カンマ区切り。例: 役員,部長,ソリューション）"),
+    bKOpr: z.string().optional().describe("キーワード結合演算子（0=OR（デフォルト）, 1=AND）"),
+}, async ({ shogo, compno, pList, cList, bKwd, bKOpr }) => {
+    const err = validateInput(shogo, compno);
+    if (err)
+        return { content: [{ type: "text", text: err }] };
+    if (!skeyKeyman) {
+        return {
+            content: [{ type: "text", text: "エラー: BIZGATE_SKEY_KEYMAN が設定されていません。" }],
+        };
+    }
+    try {
+        const { docs, numFound } = await client.searchKeyman({
+            shogo, compno, pList, cList, bKwd, bKOpr,
+        });
+        if (docs.length === 0) {
+            return {
+                content: [{ type: "text", text: `人事情報が見つかりませんでした。${usageFooter()}` }],
+            };
+        }
+        const companyName = f(docs[0].shogo);
+        const header = `## 人事情報${companyName ? `: ${companyName}` : ""}（全${numFound}件）\n`;
+        const text = docs.map((d, i) => formatKeymanDoc(d, i + 1)).join("\n\n");
+        return {
+            content: [{ type: "text", text: header + text + usageFooter() }],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: errorText(e) }] };
+    }
+});
+// ---------- Tool 5: 企業総合検索（企業+部署+キーマンを一括取得） ----------
+server.tool("bizgate__company_full", "会社名または法人番号で企業情報・部署情報・人事情報を一括取得する。個別ツールを3回呼ぶ代わりに1回で全情報を取得可能。API 3回分を消費。部署やキーワードで絞り込みも可能。", {
+    shogo: z.string().optional().describe("会社名（例：株式会社○○）"),
+    compno: z.string().optional().describe("法人番号（13桁）"),
+    hpurl: z.string().optional().describe("ホームページURL（企業特定精度向上）"),
+    email: z.string().optional().describe("メールアドレス（企業特定精度向上）"),
+    bKwd: z.string().optional().describe("部署名キーワード（部署・キーマン絞り込み。例: 人事部,営業部）"),
+    cList: z.string().optional().describe("部署カテゴリ番号（例: 3=人事, 13=営業）"),
+}, async ({ shogo, compno, hpurl, email, bKwd, cList }) => {
+    const err = validateInput(shogo, compno);
+    if (err)
+        return { content: [{ type: "text", text: err }] };
+    const sections = [];
+    // 1. Company info
+    try {
+        const { matchPattern, docs } = await client.searchCompany({
+            shogo, compno, hpurl, email,
+        });
+        if (docs.length > 0) {
+            sections.push(docs.map(formatCompanyDoc).join("\n\n"));
+            sections.push(`マッチパターン: ${matchPattern}`);
+        }
+        else {
+            sections.push(`企業情報: 該当なし（マッチパターン: ${matchPattern}）`);
+        }
+    }
+    catch (e) {
+        sections.push(`企業情報: ${e instanceof Error ? e.message : "取得失敗"}`);
+    }
+    // 2. Department info
+    try {
+        const { docs, numFound } = await client.searchDepartments({
+            shogo, compno, bKwd, cList,
+        });
+        if (docs.length > 0) {
+            const companyName = f(docs[0].shogo);
+            sections.push(`\n## 部署情報${companyName ? `: ${companyName}` : ""}（全${numFound}件）`);
+            sections.push(docs.map((d, i) => formatDepartmentDoc(d, i + 1)).join("\n\n"));
+        }
+        else {
+            sections.push("\n## 部署情報\n該当なし");
+        }
+    }
+    catch (e) {
+        if (e instanceof BizGateApiError && e.code === "504") {
+            sections.push("\n## 部署情報\nデータなし");
+        }
+        else {
+            sections.push(`\n## 部署情報\n${e instanceof Error ? e.message : "取得失敗"}`);
+        }
+    }
+    // 3. Keyman info
+    if (skeyKeyman) {
+        try {
+            const { docs, numFound } = await client.searchKeyman({
+                shogo, compno, bKwd, cList,
+            });
+            if (docs.length > 0) {
+                const companyName = f(docs[0].shogo);
+                sections.push(`\n## 人事情報${companyName ? `: ${companyName}` : ""}（全${numFound}件）`);
+                sections.push(docs.map((d, i) => formatKeymanDoc(d, i + 1)).join("\n\n"));
+            }
+            else {
+                sections.push("\n## 人事情報\n該当なし");
+            }
+        }
+        catch (e) {
+            if (e instanceof BizGateApiError && e.code === "604") {
+                sections.push("\n## 人事情報\nデータなし");
+            }
+            else {
+                sections.push(`\n## 人事情報\n${e instanceof Error ? e.message : "取得失敗"}`);
+            }
+        }
+    }
+    return {
+        content: [{ type: "text", text: sections.join("\n") + usageFooter() }],
+    };
+});
+// ---------- Tool 6: 利用状況確認 ----------
+server.tool("bizgate__usage_status", "本日のBizGate API残り利用回数を確認する（APIコールなし）", {}, async () => {
+    const remaining = usageTracker.remaining();
+    const count = usageTracker.currentCount();
+    return {
+        content: [
+            {
+                type: "text",
+                text: `本日のAPI利用状況: ${count}回使用済み / 残り${remaining}回（上限: ${dailyLimit}回）`,
+            },
+        ],
+    };
+});
+// ---------- 起動 ----------
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("BizGate MCP Server running on stdio");
+}
+main().catch(console.error);

package/dist/types.d.ts

@@ -0,0 +1,90 @@
+export interface BizGateConfig {
+    baseUrl: string;
+    skeyCompany: string;
+    skeyDepartment: string;
+    skeyMarketing: string;
+    skeyKeyman: string;
+    authMode: "basic" | "ip";
+    username?: string;
+    password?: string;
+    app?: string;
+    dailyLimit: number;
+}
+export interface BizGateRawResponse {
+    responseHeader: {
+        status: number;
+        QTime: number;
+        params: Record<string, string>;
+        matchpatern?: string;
+        warning?: string;
+        querystring?: string;
+        error?: {
+            code: string;
+            msg: string;
+        };
+    };
+    response?: {
+        numFound: number;
+        start: number;
+        docs: BizGateDoc[];
+    };
+}
+/** A single document from the BizGate response. */
+export interface BizGateDoc {
+    orgid?: string;
+    compno?: string;
+    shogo?: string[];
+    update?: string;
+    pageitem?: string;
+    pagecat?: string[];
+    add?: string[];
+    pref?: string[];
+    citycode?: string[];
+    zip?: string[];
+    tel?: string[];
+    fax?: string[];
+    mail?: string[];
+    hpurl?: string[];
+    ceo?: string[];
+    gyoshu_facet?: string[];
+    gyoshu_dcat?: string;
+    shihon?: string;
+    emp?: string;
+    revenue?: string;
+    pub?: string;
+    bumon?: string[];
+    kessanm?: string;
+    seturitu?: string;
+    invoiceno?: string;
+    inquryurl?: string[];
+    id?: string;
+    pagedate?: string;
+    haturei?: string;
+    bikou?: string;
+    snstag?: string;
+    matag?: string;
+    servicetag?: string;
+    activtag?: string;
+    ctg_01?: string;
+    ctg_02?: string;
+    ctg_03?: string;
+    ctg_04?: string;
+    ctg_05?: string;
+    ctg_06?: string;
+    ctg_07?: string;
+    ctg_08?: string;
+    ctg_09?: string;
+    ctg_10?: string;
+    ctg_11?: string;
+    ctg_12?: string;
+    ctg_13?: string;
+    ctg_14?: string;
+    ctg_15?: string;
+    [key: string]: unknown;
+}
+export declare const DEPARTMENT_CATEGORIES: Record<string, string>;
+export declare const BIZGATE_ERROR_CODES: Record<string, string>;
+export declare class BizGateApiError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}

package/dist/types.js

@@ -0,0 +1,49 @@
+// --- Department category labels ---
+export const DEPARTMENT_CATEGORIES = {
+    ctg_01: "経営企画",
+    ctg_02: "営業企画・マーケティング",
+    ctg_03: "人事",
+    ctg_04: "経理",
+    ctg_05: "総務管理",
+    ctg_06: "広報IR",
+    ctg_07: "法務リスク",
+    ctg_08: "研究",
+    ctg_09: "購買資材",
+    ctg_10: "システム",
+    ctg_11: "海外",
+    ctg_12: "環境CSR",
+    ctg_13: "営業",
+    ctg_14: "製造工場",
+    ctg_15: "その他",
+};
+// --- Error codes → Japanese messages ---
+export const BIZGATE_ERROR_CODES = {
+    "101": "認証コードを指定してください",
+    "102": "問合せパラメータに有効なサービスキーを設定してください",
+    "111": "有効な認証コードを指定してください",
+    "112": "1日の利用出来るリクエストの上限を超えています",
+    "113": "リクエストのカウントアップに失敗しました",
+    "201": "検索に使用できない文字を除いて、再度リクエストを送信してください",
+    "202": "企業を特定するために、商号若しくは法人番号のいずれかを指定してください",
+    "203": "有効な認証コードを指定してください",
+    "204": "検索の結果、一致する企業が存在しませんでした",
+    "205": "検索の結果、複数の企業が存在します",
+    "206": "検索の結果、商号を得ることができませんでした",
+    "207": "検索の結果、古い登記情報と一致しました",
+    "404": "検索の結果、該当企業にはタグデータが付加されていませんでした",
+    "501": "検索に使用できない文字を除いて、再度リクエストを送信してください",
+    "504": "検索の結果、該当企業の部署データは0件でした",
+    "601": "検索に使用できない文字を除いて、再度リクエストを送信してください",
+    "604": "検索の結果、該当企業の人事情報データは0件でした",
+    "1001": "データベースへの接続が確立しませんでした",
+    "1002": "SQLステートメントの実行に失敗しました",
+};
+// --- Custom error class ---
+export class BizGateApiError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "BizGateApiError";
+    }
+}

package/dist/usage-tracker.d.ts

@@ -0,0 +1,15 @@
+export declare class UsageTracker {
+    private filePath;
+    private limit;
+    constructor(filePath: string, limit: number);
+    /** Get today's date string in JST (Asia/Tokyo) */
+    private todayJST;
+    private readState;
+    private writeState;
+    /** Increment counter before making an API call. Throws if limit exceeded. */
+    increment(cost?: number): number;
+    /** Remaining requests for today. */
+    remaining(): number;
+    /** Current usage count for today. */
+    currentCount(): number;
+}

package/dist/usage-tracker.js

@@ -0,0 +1,48 @@
+import { readFileSync, writeFileSync } from "node:fs";
+export class UsageTracker {
+    filePath;
+    limit;
+    constructor(filePath, limit) {
+        this.filePath = filePath;
+        this.limit = limit;
+    }
+    /** Get today's date string in JST (Asia/Tokyo) */
+    todayJST() {
+        return new Date().toLocaleDateString("en-CA", { timeZone: "Asia/Tokyo" });
+    }
+    readState() {
+        try {
+            const raw = readFileSync(this.filePath, "utf-8");
+            const state = JSON.parse(raw);
+            if (state.date === this.todayJST()) {
+                return state;
+            }
+        }
+        catch {
+            // File missing or corrupted — start fresh
+        }
+        return { date: this.todayJST(), count: 0 };
+    }
+    writeState(state) {
+        writeFileSync(this.filePath, JSON.stringify(state), "utf-8");
+    }
+    /** Increment counter before making an API call. Throws if limit exceeded. */
+    increment(cost = 1) {
+        const state = this.readState();
+        if (state.count + cost > this.limit) {
+            throw new Error(`本日のAPI利用上限（${this.limit}回）に達しました。明日以降に再度お試しください。`);
+        }
+        state.count += cost;
+        this.writeState(state);
+        return state.count;
+    }
+    /** Remaining requests for today. */
+    remaining() {
+        const state = this.readState();
+        return Math.max(0, this.limit - state.count);
+    }
+    /** Current usage count for today. */
+    currentCount() {
+        return this.readState().count;
+    }
+}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "bizgate-mcp-server",
+  "version": "0.1.0",
+  "description": "BizGate APIとClaudeを連携するMCPサーバー",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "bizgate-mcp-server": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.8.3"
+  }
+}