edition-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,90 @@
+# edition-mcp-server
+
+MCP server for the **EDITION Intelligence Platform** — contextual intelligence infrastructure for AI agents operating in Japan.
+
+## What it does
+
+Provides 8 tools that give AI agents the ability to:
+
+- **Remember** conversations with Japanese-aware fact extraction (keigo analysis, social hierarchy detection, confidence scoring)
+- **Navigate** Japanese business regulations across 10 industries + tourist rules
+
+## Install
+
+```bash
+npx edition-mcp-server
+```
+
+Or install globally:
+
+```bash
+npm install -g edition-mcp-server
+edition-mcp
+```
+
+## Configure
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "edition": {
+      "command": "npx",
+      "args": ["-y", "edition-mcp-server"],
+      "env": {
+        "EDITION_API_URL": "http://localhost:8000",
+        "EDITION_API_KEY": "your_api_key"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add to MCP settings:
+
+```json
+{
+  "edition": {
+    "command": "npx",
+    "args": ["-y", "edition-mcp-server"],
+    "env": {
+      "EDITION_API_URL": "http://localhost:8000",
+      "EDITION_API_KEY": "your_api_key"
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `memory_store` | Store episode + auto-extract structured facts from Japanese text |
+| `memory_recall` | Semantic search across stored episodes |
+| `memory_facts` | List structured facts (subject → predicate → object with confidence) |
+| `memory_context` | Get context summary for an entity or session |
+| `memory_extract` | Extract facts from text with keigo/hierarchy analysis |
+| `regulation_check` | Check Japanese business regulations by industry |
+| `regulation_industries` | List all 10 supported industries |
+| `regulation_tourist` | Tourist regulation lookup (visa, tax-free, transit, etc.) |
+
+## Backend
+
+This MCP server connects to the EDITION REST API backend. To run your own:
+
+```bash
+git clone https://github.com/hiroshic9-png/edition.git
+cd edition
+python3 -m venv venv && source venv/bin/activate
+pip install -r requirements.txt
+python -m uvicorn backend.api.main:app --reload
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * EDITION Intelligence Platform — MCP Server
+ *
+ * AI agents can use these tools to:
+ * - Store and recall memories with Japanese language understanding
+ * - Check Japanese business regulations and compliance requirements
+ * - Get tourist/visitor information for Japan
+ *
+ * Connects to the EDITION REST API backend.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,363 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * EDITION Intelligence Platform — MCP Server
+ *
+ * AI agents can use these tools to:
+ * - Store and recall memories with Japanese language understanding
+ * - Check Japanese business regulations and compliance requirements
+ * - Get tourist/visitor information for Japan
+ *
+ * Connects to the EDITION REST API backend.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+// ── Configuration ───────────────────────────────────
+const API_BASE = process.env.EDITION_API_URL || "https://edition-api.onrender.com";
+const API_KEY = process.env.EDITION_API_KEY || "edition_dev_key_for_testing";
+// ── HTTP helpers ────────────────────────────────────
+async function apiGet(path) {
+    const res = await fetch(`${API_BASE}${path}`, {
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`API error ${res.status}: ${await res.text()}`);
+    }
+    return res.json();
+}
+async function apiPost(path, body) {
+    const res = await fetch(`${API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${API_KEY}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        throw new Error(`API error ${res.status}: ${await res.text()}`);
+    }
+    return res.json();
+}
+// ── MCP Server ──────────────────────────────────────
+const server = new mcp_js_1.McpServer({
+    name: "edition",
+    version: "0.1.0",
+});
+// ── Tool: memory_store ──────────────────────────────
+server.tool("memory_store", "会話やイベントのエピソードを永続記憶に保存します。日本語の文脈（敬語レベル、主語省略、暗黙の了解）も構造化して保持します。auto_extract=trueにすると、テキストからファクト（主語→述語→目的語の三つ組）を自動抽出します。", {
+    content: zod_1.z.string().describe("保存する内容（日本語/英語対応）"),
+    session_id: zod_1.z.string().optional().describe("セッション識別子"),
+    role: zod_1.z.enum(["user", "assistant", "system"]).default("user").describe("発話者の役割"),
+    auto_extract: zod_1.z.boolean().default(false).describe("LLMでファクトを自動抽出するか"),
+}, async ({ content, session_id, role, auto_extract }) => {
+    const result = await apiPost("/api/v1/memory/episodes", {
+        content,
+        session_id,
+        role,
+        auto_extract,
+    });
+    let text = `✅ エピソードを保存しました (ID: ${result.id})`;
+    if (result.extracted_facts?.length) {
+        text += `\n\n📋 自動抽出されたファクト (${result.extracted_facts.length}件):`;
+        for (const f of result.extracted_facts) {
+            text += `\n  - ${f.subject} → ${f.predicate} → ${f.object} (確度: ${(f.confidence * 100).toFixed(0)}%)`;
+        }
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: memory_recall ─────────────────────────────
+server.tool("memory_recall", "過去の記憶をセマンティック検索で呼び出します。「前回の会議で○○部長が仰った件」のような曖昧な日本語クエリにも対応します。", {
+    query: zod_1.z.string().describe("検索クエリ（日本語/英語対応）"),
+    limit: zod_1.z.number().int().min(1).max(20).default(5).describe("取得件数"),
+}, async ({ query, limit }) => {
+    const result = await apiPost("/api/v1/memory/episodes/search", {
+        query,
+        limit,
+    });
+    if (!result.results?.length) {
+        return { content: [{ type: "text", text: "該当する記憶が見つかりませんでした。" }] };
+    }
+    let text = `🔍 検索結果 (${result.count}件):`;
+    for (const r of result.results) {
+        const dist = r.distance ? ` [類似度: ${(1 - r.distance).toFixed(2)}]` : "";
+        text += `\n\n---\n${r.document}${dist}`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: memory_facts ──────────────────────────────
+server.tool("memory_facts", "現在有効なファクト（構造化された事実）の一覧を取得します。ファクトは「主語→述語→目的語」の三つ組で、確度と有効期限を持ちます。", {
+    valid_only: zod_1.z.boolean().default(true).describe("有効なファクトのみ取得するか"),
+}, async ({ valid_only }) => {
+    const result = await apiGet(`/api/v1/memory/facts?valid_only=${valid_only}`);
+    if (!result.facts?.length) {
+        return { content: [{ type: "text", text: "保存されたファクトはありません。" }] };
+    }
+    let text = `📝 ファクト一覧 (${result.count}件):`;
+    for (const f of result.facts) {
+        const conf = f.confidence < 1.0 ? ` (確度: ${(f.confidence * 100).toFixed(0)}%)` : "";
+        text += `\n  - ${f.subject} → ${f.predicate} → ${f.object}${conf}`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: memory_context ────────────────────────────
+server.tool("memory_context", "現在のセッション状態（有効な事実・合意事項のサマリー）を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。", {
+    session_id: zod_1.z.string().optional().describe("セッションID（省略で全体）"),
+}, async ({ session_id }) => {
+    const params = session_id ? `?session_id=${encodeURIComponent(session_id)}` : "";
+    const result = await apiGet(`/api/v1/memory/context${params}`);
+    let text = `📌 コンテキストサマリー\n`;
+    text += `有効なファクト: ${result.active_facts_count}件\n`;
+    text += `直近のエピソード: ${result.recent_episodes_count}件\n\n`;
+    text += result.summary;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: memory_extract ────────────────────────────
+server.tool("memory_extract", "テキストからファクトを自動抽出します。日本語の敬語・主語省略・社会的階層を分析して構造化します。store=trueで永続保存。", {
+    text: zod_1.z.string().describe("ファクトを抽出するテキスト"),
+    context_hint: zod_1.z.string().default("").describe("コンテキストヒント（例: ビジネスミーティング）"),
+    store: zod_1.z.boolean().default(false).describe("抽出したファクトを永続保存するか"),
+}, async ({ text, context_hint, store }) => {
+    const result = await apiPost("/api/v1/memory/extract", {
+        text,
+        context_hint,
+        store,
+    });
+    if (!result.extracted_facts?.length) {
+        return { content: [{ type: "text", text: "テキストからファクトを抽出できませんでした。" }] };
+    }
+    let response = `📋 抽出されたファクト (${result.extracted_facts.length}件):`;
+    for (const f of result.extracted_facts) {
+        const conf = f.confidence ? ` (確度: ${(f.confidence * 100).toFixed(0)}%)` : "";
+        response += `\n  - ${f.subject} → ${f.predicate} → ${f.object}${conf}`;
+    }
+    response += `\n\n${result.stored ? "💾 保存済み" : "💡 未保存（store=trueで保存）"}`;
+    return { content: [{ type: "text", text: response }] };
+});
+// ── Tool: regulation_check ──────────────────────────
+server.tool("regulation_check", "特定のビジネスアクションに必要な日本の規制・許認可情報を回答します。10業種の詳細データベース + 訪日旅行者向け規制に対応。", {
+    action: zod_1.z.string().describe("実行しようとしているアクション（例: 東京でレストランを開業する）"),
+    industry: zod_1.z.string().optional().describe("業種（省略可、自動判定）"),
+    entity_type: zod_1.z.enum(["foreign_company", "domestic_company", "individual", "tourist"]).default("foreign_company").describe("主体の種別"),
+}, async ({ action, industry, entity_type }) => {
+    const result = await apiPost("/api/v1/regulation/check", {
+        action,
+        industry,
+        entity_type,
+    });
+    let text = "";
+    if (result.category === "tourist") {
+        // Tourist regulation response
+        text = `🗾 訪日旅行者向け規制: ${result.matched_topic}\n\n`;
+        text += `📋 概要: ${result.overview}\n\n`;
+        text += `📌 主なルール:\n`;
+        for (const rule of result.key_rules || []) {
+            text += `  - ${rule}\n`;
+        }
+    }
+    else if (result.matched_industry) {
+        // Business regulation response
+        text = `🏢 業種: ${result.matched_industry}\n`;
+        text += `📋 必要な許認可: ${(result.licenses_required || []).join(", ")}\n`;
+        text += `🏛️ 管轄: ${result.governing_body || ""}\n`;
+        text += `📖 根拠法: ${result.governing_law || ""}\n\n`;
+        text += `📌 要件:\n`;
+        for (const req of result.requirements || []) {
+            text += `  - ${req}\n`;
+        }
+        text += `\n⏱️ 期間: ${result.estimated_timeline || ""}`;
+        text += `\n💰 費用: ${result.costs || ""}`;
+        if (result.foreign_company_notes) {
+            text += `\n\n🌐 外国企業向け: ${result.foreign_company_notes}`;
+        }
+        if (result.penalties_for_non_compliance) {
+            text += `\n\n⚠️ 違反時: ${result.penalties_for_non_compliance}`;
+        }
+    }
+    else {
+        text = `❌ ${result.message || "該当する規制情報が見つかりませんでした。"}`;
+        if (result.suggestion)
+            text += `\n\n💡 ${result.suggestion}`;
+    }
+    text += `\n\n📊 確度: ${((result.confidence || 0) * 100).toFixed(0)}%`;
+    text += `\n⚠️ ${result.disclaimer || "この情報は参考用です。法的助言ではありません。"}`;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: regulation_industries ──────────────────────
+server.tool("regulation_industries", "日本の規制データベースに登録されている業種の一覧を取得します。", {}, async () => {
+    const result = await apiGet("/api/v1/regulation/industries");
+    let text = `🗾 対応業種一覧 (${result.count}業種):\n\n`;
+    for (const ind of result.industries) {
+        text += `  🏢 ${ind.industry}\n`;
+        text += `     許認可: ${ind.licenses.join(", ")}\n`;
+        text += `     管轄: ${ind.governing_body}\n`;
+        text += `     根拠法: ${ind.governing_law}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: regulation_tourist ────────────────────────
+server.tool("regulation_tourist", "訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。", {}, async () => {
+    const result = await apiGet("/api/v1/regulation/tourist");
+    let text = `🗾 訪日旅行者向け規制カテゴリ (${result.count}件):\n\n`;
+    for (const cat of result.categories) {
+        text += `  📋 ${cat.category}: ${cat.overview}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: protocol_check ────────────────────────────
+server.tool("protocol_check", "日本のビジネスプロトコル（根回し、稟議、報連相、名刺交換、席順、贈答）を検索します。", {
+    query: zod_1.z.string().describe("検索クエリ（例: '名刺交換の作法', '根回し'）"),
+}, async ({ query }) => {
+    const result = await apiPost("/api/v1/protocol/check", { query });
+    if (!result.protocol_id && !result.name_ja) {
+        return { content: [{ type: "text", text: `❌ '${query}' に該当するプロトコルが見つかりませんでした。` }] };
+    }
+    let text = `🤝 ${result.name_ja || result.protocol_id}\n`;
+    text += `📋 ${result.summary || ""}\n`;
+    if (result.how_to) {
+        text += `\n📌 手順:\n`;
+        for (const step of result.how_to) {
+            text += `  ${step.step}. ${step.action}: ${step.detail}\n`;
+        }
+    }
+    if (result.protocol) {
+        text += `\n📌 手順:\n`;
+        for (const step of result.protocol) {
+            text += `  ${step.step}. ${step.action}: ${step.detail}\n`;
+        }
+    }
+    text += `\n📊 確度: ${((result.confidence || 0) * 100).toFixed(0)}%`;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: protocol_list ─────────────────────────────
+server.tool("protocol_list", "日本のビジネスプロトコルの一覧を取得します。", {}, async () => {
+    const result = await apiGet("/api/v1/protocol/list");
+    let text = `🤝 プロトコル一覧 (${result.count}件):\n\n`;
+    for (const p of result.protocols) {
+        text += `  • ${p.name_ja} (${p.name_en}) — ${p.importance}\n    ${p.summary}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: calendar_check ────────────────────────────
+server.tool("calendar_check", "日本のビジネスカレンダー情報を検索します。祝日、決算期、贈答シーズン、行政締切、季節性ビジネスの5カテゴリ。", {
+    query: zod_1.z.string().describe("検索クエリ（例: '開業のベストタイミング', 'GW', '確定申告の締切'）"),
+}, async ({ query }) => {
+    const result = await apiPost("/api/v1/calendar/check", { query });
+    if (!result.category_id) {
+        return { content: [{ type: "text", text: `❌ '${query}' に該当するカレンダー情報が見つかりませんでした。` }] };
+    }
+    let text = `📅 ${result.name_ja}\n📋 ${result.summary}\n`;
+    text += `\n📊 確度: ${((result.confidence || 0) * 100).toFixed(0)}%`;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: calendar_list ─────────────────────────────
+server.tool("calendar_list", "日本のビジネスカレンダーの全カテゴリ一覧を取得します。", {}, async () => {
+    const result = await apiGet("/api/v1/calendar/list");
+    let text = `📅 カレンダーカテゴリ一覧 (${result.count}件):\n\n`;
+    for (const c of result.categories) {
+        text += `  • ${c.name_ja} (${c.name_en})\n    ${c.summary}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: regional_check ────────────────────────────
+server.tool("regional_check", "日本の地域別ビジネス情報を検索します。主要都市の特性、自治体の助成金・補助金、地域条例、商慣習の違い。", {
+    query: zod_1.z.string().describe("検索クエリ（例: '大阪の飲食店条例', '東京のスタートアップ助成金'）"),
+}, async ({ query }) => {
+    const result = await apiPost("/api/v1/regional/check", { query });
+    if (!result.category_id) {
+        return { content: [{ type: "text", text: `❌ '${query}' に該当する地域情報が見つかりませんでした。` }] };
+    }
+    let text = `🗺️ ${result.name_ja}\n📋 ${result.summary}\n`;
+    text += `\n📊 確度: ${((result.confidence || 0) * 100).toFixed(0)}%`;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: regional_list ─────────────────────────────
+server.tool("regional_list", "日本の地域別ビジネス情報の全カテゴリ一覧を取得します。", {}, async () => {
+    const result = await apiGet("/api/v1/regional/list");
+    let text = `🗺️ 地域情報カテゴリ一覧 (${result.count}件):\n\n`;
+    for (const c of result.categories) {
+        text += `  • ${c.name_ja} (${c.name_en})\n    ${c.summary}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: organization_check ────────────────────────
+server.tool("organization_check", "日本の組織構造・商慣行を検索します。役職体系、系列、支払慣行、契約慣行、業界団体。", {
+    query: zod_1.z.string().describe("検索クエリ（例: '支払いサイトの標準', '契約書の印鑑', '部長と課長の違い'）"),
+}, async ({ query }) => {
+    const result = await apiPost("/api/v1/organization/check", { query });
+    if (!result.category_id) {
+        return { content: [{ type: "text", text: `❌ '${query}' に該当する組織情報が見つかりませんでした。` }] };
+    }
+    let text = `🏛️ ${result.name_ja}\n📋 ${result.summary}\n`;
+    text += `\n📊 確度: ${((result.confidence || 0) * 100).toFixed(0)}%`;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: organization_list ─────────────────────────
+server.tool("organization_list", "日本の組織構造・商慣行の全カテゴリ一覧を取得します。", {}, async () => {
+    const result = await apiGet("/api/v1/organization/list");
+    let text = `🏛️ 組織情報カテゴリ一覧 (${result.count}件):\n\n`;
+    for (const c of result.categories) {
+        text += `  • ${c.name_ja} (${c.name_en})\n    ${c.summary}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: foreign_entry_check ───────────────────────
+server.tool("foreign_entry_check", "外国企業・外国人の日本進出に必要な基盤知識を検索します。法人設立、経営管理ビザ、銀行口座開設、物件探し、税務届出の5カテゴリ。", {
+    query: zod_1.z.string().describe("検索クエリ（例: '法人設立の手順', 'ビザ取得', '銀行口座開設'）"),
+}, async ({ query }) => {
+    const result = await apiPost("/api/v1/foreign-entry/check", { query });
+    if (!result.category_id) {
+        return { content: [{ type: "text", text: `❌ '${query}' に該当する進出情報が見つかりませんでした。` }] };
+    }
+    let text = `🌐 ${result.name_ja}\n📋 ${result.summary}\n`;
+    if (result.procedures) {
+        text += `\n📌 手順 (${result.procedures.length}ステップ):\n`;
+        for (const s of result.procedures) {
+            text += `  ${s.step}. ${s.what}: ${s.detail}\n`;
+        }
+    }
+    text += `\n📊 確度: ${((result.confidence || 0) * 100).toFixed(0)}%`;
+    text += `\n⚠️ ${result.disclaimer || "この情報は一般的なガイダンスです。"}`;
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: foreign_entry_list ────────────────────────
+server.tool("foreign_entry_list", "外国企業・外国人の日本進出に関する知識カテゴリの一覧を取得します。", {}, async () => {
+    const result = await apiGet("/api/v1/foreign-entry/list");
+    let text = `🌐 日本進出カテゴリ一覧 (${result.count}件):\n\n`;
+    for (const c of result.categories) {
+        text += `  • ${c.name_ja} (${c.name_en})\n    ${c.summary}\n\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Tool: search ────────────────────────────────────
+server.tool("search", "EDITION全ドメインを横断検索します。1回のリクエストで規制・プロトコル・カレンダー・地域・組織・進出手続きの全6ドメインを同時検索。", {
+    query: zod_1.z.string().describe("検索クエリ（例: '大阪で飲食店を開業', '外国人のビザ取得と銀行口座'）"),
+}, async ({ query }) => {
+    const result = await apiPost("/api/v1/search", { query });
+    let text = `🔍 横断検索結果: ${result.domains_matched}/${result.domains_searched} ドメインでヒット\n\n`;
+    for (const [domain, data] of Object.entries(result.results)) {
+        const name = data.name_ja || data.industry || domain;
+        text += `  ✅ ${domain}: ${name} (確度: ${((data.confidence || 0) * 100).toFixed(0)}%)\n`;
+        if (data.summary)
+            text += `     ${data.summary}\n`;
+    }
+    if (result.domains_matched === 0) {
+        text += `  ❌ 該当する情報が見つかりませんでした。\n`;
+    }
+    return { content: [{ type: "text", text }] };
+});
+// ── Start ───────────────────────────────────────────
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("EDITION Intelligence Platform MCP server started (stdio)");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "edition-mcp-server",
+  "version": "0.1.0",
+  "description": "EDITION Intelligence Platform — MCP server for Japanese business memory + regulation check",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "edition-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "japan",
+    "memory",
+    "regulation",
+    "agent",
+    "ai",
+    "compliance"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0"
+  }
+}