edition-mcp-server 0.1.5 → 0.2.1

package/README.md

@@ -1,15 +1,11 @@
-# edition-mcp-server
+# EDITION Intelligence Platform — MCP Server
 
-MCP server for the **EDITION Intelligence Platform** — contextual intelligence infrastructure for AI agents operating in Japan.
+Japan Operations OS for autonomous AI agents. 14 knowledge domains, 31 MCP tools, 2 prompt templates — verified, structured intelligence for agents operating in Japan.
 
-## What it does
+[![npm](https://img.shields.io/npm/v/edition-mcp-server)](https://www.npmjs.com/package/edition-mcp-server)
+[![License: MIT](https://img.shields.io/badge/License-MIT-black.svg)](https://opensource.org/licenses/MIT)
 
-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
+## Installation
 
 ```bash
 npx edition-mcp-server
@@ -22,8 +18,6 @@ npm install -g edition-mcp-server
 edition-mcp
 ```
 
-## Configure
-
 ### Claude Desktop
 
 Add to `claude_desktop_config.json`:
@@ -33,19 +27,28 @@ Add to `claude_desktop_config.json`:
   "mcpServers": {
     "edition": {
       "command": "npx",
-      "args": ["-y", "edition-mcp-server"],
-      "env": {
-        "EDITION_API_URL": "http://localhost:8000",
-        "EDITION_API_KEY": "your_api_key"
-      }
+      "args": ["-y", "edition-mcp-server"]
     }
   }
 }
 ```
 
-### Cursor
+### Cursor / Windsurf / VS Code
 
-Add to MCP settings:
+Add to your MCP settings:
+
+```json
+{
+  "edition": {
+    "command": "npx",
+    "args": ["-y", "edition-mcp-server"]
+  }
+}
+```
+
+### Custom API URL
+
+By default connects to `https://api.edition.sh`. Override with environment variables:
 
 ```json
 {
@@ -53,8 +56,8 @@ Add to MCP settings:
     "command": "npx",
     "args": ["-y", "edition-mcp-server"],
     "env": {
-      "EDITION_API_URL": "http://localhost:8000",
-      "EDITION_API_KEY": "your_api_key"
+      "EDITION_API_URL": "https://api.edition.sh",
+      "EDITION_API_KEY": "edition_dev_key_for_testing"
     }
   }
 }
@@ -62,28 +65,134 @@ Add to MCP settings:
 
 ## Tools
 
+### Memory (5 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.) |
+| `memory_store` | Store episodes to persistent memory with Japanese language understanding (keigo, subject omission, implicit context) |
+| `memory_recall` | Semantic search across stored memories — handles ambiguous Japanese queries |
+| `memory_facts` | List structured facts as subject → predicate → object triples with confidence scores |
+| `memory_context` | Get current session context summary for prompt injection |
+| `memory_extract` | Auto-extract structured facts from text with keigo/hierarchy analysis |
 
-## Backend
+### Regulations (3 tools)
 
-This MCP server connects to the EDITION REST API backend. To run your own:
+| Tool | Description |
+|------|-------------|
+| `regulation_check` | Check Japan business regulations — licenses, governing bodies, penalties, costs, timelines for 10 industries |
+| `regulation_industries` | List all 10 regulated industries with their requirements |
+| `regulation_tourist` | Tourist/visitor regulation categories (visa, tax-free, transport, accommodation, medical, manners) |
 
-```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
-```
+### Protocols (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `protocol_check` | Search Japanese business protocols — nemawashi, ringi, hourensou, meishi exchange, seating order, gift-giving |
+| `protocol_list` | List all business protocols with importance levels |
+
+### Calendar (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `calendar_check` | Search Japan business calendar — fiscal year, holidays, gift seasons, deadlines, seasonal patterns |
+| `calendar_list` | List all calendar categories |
+
+### Regional (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `regional_check` | Search regional business differences — city characteristics, subsidies, local regulations, business customs |
+| `regional_list` | List all regional categories |
+
+### Organization (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `organization_check` | Search organizational structures — keiretsu, corporate hierarchy, payment customs, contract practices |
+| `organization_list` | List all organization categories |
+
+### Foreign Entry (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `foreign_entry_check` | Japan market entry guides — incorporation, management visa, bank account, real estate, tax registration |
+| `foreign_entry_list` | List all foreign entry categories |
+
+### Travel (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `travel_search` | Search Japan travel knowledge — shinkansen, IC cards, ryokan etiquette, tipping culture |
+| `travel_list` | List all travel topics |
+
+### Entertainment (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `entertainment_search` | Search Japan entertainment — oshi-katsu fan culture, anime pilgrimage, live events, seasonal festivals |
+| `entertainment_list` | List all entertainment topics |
+
+### Daily Life (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `daily_life_search` | Search daily life in Japan — postal/address system, garbage sorting, utilities, healthcare/insurance |
+| `daily_life_list` | List all daily life topics |
+
+### Language (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `language_search` | Search Japanese language structures — keigo system, counter words (josushi), name patterns, business templates |
+| `language_list` | List all language topics |
+
+### Food Culture (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `food_search` | Search Japan food culture — dining etiquette, cuisine types, restaurant navigation, dietary restrictions (halal, vegetarian) |
+| `food_list` | List all food culture topics |
+
+### Disaster & Safety (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `disaster_search` | Search disaster/safety knowledge — earthquake shindo scale, typhoon warnings, emergency contacts (110/119), disaster preparedness |
+| `disaster_list` | List all disaster & safety topics |
+
+### Cross-Domain (1 tool)
+
+| Tool | Description |
+|------|-------------|
+| `search` | Cross-domain search across all 14 knowledge domains simultaneously — one query returns matches from all domains |
+
+## Prompt Templates
+
+| Prompt | Description |
+|--------|-------------|
+| `japan_business_briefing` | Generate a comprehensive Japan business briefing for a specific industry |
+| `japan_travel_guide` | Generate a practical travel guide for a specific Japan destination |
+
+## Resources
+
+| Resource | Description |
+|----------|-------------|
+| `edition://domains` | List of all 14 knowledge domains with descriptions and endpoint information |
+| `edition://quality` | Trust Anchor quality scores for each domain — verified data coverage metrics |
+
+## Architecture
+
+EDITION uses a three-layer knowledge architecture:
+
+1. **Rules** — Official regulations, procedures, and requirements
+2. **Context** — Unwritten rules, cultural "why", and implicit expectations
+3. **Experience** — How to turn correct execution into relationship-building moments
+
+## API
+
+- **REST API**: [https://api.edition.sh](https://api.edition.sh)
+- **API Docs**: [https://api.edition.sh/docs](https://api.edition.sh/docs)
+- **Landing Page**: [https://edition.sh](https://edition.sh)
 
 ## License
 

package/dist/index.js

@@ -47,7 +47,7 @@ async function apiPost(path, body) {
 // ── MCP Server ──────────────────────────────────────
 const server = new mcp_js_1.McpServer({
     name: "edition",
-    version: "0.1.5",
+    version: "0.2.0",
 });
 // ── Tool: memory_store ──────────────────────────────
 server.tool("memory_store", "会話やイベントのエピソードを永続記憶に保存します。日本語の文脈（敬語レベル、主語省略、暗黙の了解）も構造化して保持します。auto_extract=trueにすると、テキストからファクト（主語→述語→目的語の三つ組）を自動抽出します。", {
@@ -55,7 +55,7 @@ server.tool("memory_store", "会話やイベントのエピソードを永続記
     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 }) => {
+}, { readOnlyHint: false, destructiveHint: false, idempotentHint: false }, async ({ content, session_id, role, auto_extract }) => {
     const result = await apiPost("/api/v1/memory/episodes", {
         content,
         session_id,
@@ -75,7 +75,7 @@ server.tool("memory_store", "会話やイベントのエピソードを永続記
 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 }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query, limit }) => {
     const result = await apiPost("/api/v1/memory/episodes/search", {
         query,
         limit,
@@ -93,7 +93,7 @@ server.tool("memory_recall", "過去の記憶をセマンティック検索で
 // ── Tool: memory_facts ──────────────────────────────
 server.tool("memory_facts", "現在有効なファクト（構造化された事実）の一覧を取得します。ファクトは「主語→述語→目的語」の三つ組で、確度と有効期限を持ちます。", {
     valid_only: zod_1.z.boolean().default(true).describe("有効なファクトのみ取得するか"),
-}, async ({ valid_only }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ valid_only }) => {
     const result = await apiGet(`/api/v1/memory/facts?valid_only=${valid_only}`);
     if (!result.facts?.length) {
         return { content: [{ type: "text", text: "保存されたファクトはありません。" }] };
@@ -108,7 +108,7 @@ server.tool("memory_facts", "現在有効なファクト（構造化された事
 // ── Tool: memory_context ────────────────────────────
 server.tool("memory_context", "現在のセッション状態（有効な事実・合意事項のサマリー）を取得します。エージェントのプロンプトに注入して文脈を維持するために使います。", {
     session_id: zod_1.z.string().optional().describe("セッションID（省略で全体）"),
-}, async ({ session_id }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ session_id }) => {
     const params = session_id ? `?session_id=${encodeURIComponent(session_id)}` : "";
     const result = await apiGet(`/api/v1/memory/context${params}`);
     let text = `📌 コンテキストサマリー\n`;
@@ -122,7 +122,7 @@ server.tool("memory_extract", "テキストからファクトを自動抽出し
     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 }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ text, context_hint, store }) => {
     const result = await apiPost("/api/v1/memory/extract", {
         text,
         context_hint,
@@ -144,7 +144,7 @@ server.tool("regulation_check", "特定のビジネスアクションに必要
     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 }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ action, industry, entity_type }) => {
     const result = await apiPost("/api/v1/regulation/check", {
         action,
         industry,
@@ -189,7 +189,7 @@ server.tool("regulation_check", "特定のビジネスアクションに必要
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: regulation_industries ──────────────────────
-server.tool("regulation_industries", "日本の規制データベースに登録されている業種の一覧を取得します。", {}, async () => {
+server.tool("regulation_industries", "日本の規制データベースに登録されている業種の一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/regulation/industries");
     let text = `🗾 対応業種一覧 (${result.count}業種):\n\n`;
     for (const ind of result.industries) {
@@ -201,7 +201,7 @@ server.tool("regulation_industries", "日本の規制データベースに登録
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: regulation_tourist ────────────────────────
-server.tool("regulation_tourist", "訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。", {}, async () => {
+server.tool("regulation_tourist", "訪日旅行者向けの規制・マナー情報のカテゴリ一覧を取得します。ビザ、免税、交通、宿泊、医療、マナーの6カテゴリ。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/regulation/tourist");
     let text = `🗾 訪日旅行者向け規制カテゴリ (${result.count}件):\n\n`;
     for (const cat of result.categories) {
@@ -212,7 +212,7 @@ server.tool("regulation_tourist", "訪日旅行者向けの規制・マナー情
 // ── Tool: protocol_check ────────────────────────────
 server.tool("protocol_check", "日本のビジネスプロトコル（根回し、稟議、報連相、名刺交換、席順、贈答）を検索します。", {
     query: zod_1.z.string().describe("検索クエリ（例: '名刺交換の作法', '根回し'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/protocol/check", { query });
     if (!result.protocol_id && !result.name_ja) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当するプロトコルが見つかりませんでした。` }] };
@@ -235,7 +235,7 @@ server.tool("protocol_check", "日本のビジネスプロトコル（根回し
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: protocol_list ─────────────────────────────
-server.tool("protocol_list", "日本のビジネスプロトコルの一覧を取得します。", {}, async () => {
+server.tool("protocol_list", "日本のビジネスプロトコルの一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/protocol/list");
     let text = `🤝 プロトコル一覧 (${result.count}件):\n\n`;
     for (const p of result.protocols) {
@@ -246,7 +246,7 @@ server.tool("protocol_list", "日本のビジネスプロトコルの一覧を
 // ── Tool: calendar_check ────────────────────────────
 server.tool("calendar_check", "日本のビジネスカレンダー情報を検索します。祝日、決算期、贈答シーズン、行政締切、季節性ビジネスの5カテゴリ。", {
     query: zod_1.z.string().describe("検索クエリ（例: '開業のベストタイミング', 'GW', '確定申告の締切'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/calendar/check", { query });
     if (!result.category_id) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当するカレンダー情報が見つかりませんでした。` }] };
@@ -256,7 +256,7 @@ server.tool("calendar_check", "日本のビジネスカレンダー情報を検
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: calendar_list ─────────────────────────────
-server.tool("calendar_list", "日本のビジネスカレンダーの全カテゴリ一覧を取得します。", {}, async () => {
+server.tool("calendar_list", "日本のビジネスカレンダーの全カテゴリ一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/calendar/list");
     let text = `📅 カレンダーカテゴリ一覧 (${result.count}件):\n\n`;
     for (const c of result.categories) {
@@ -267,7 +267,7 @@ server.tool("calendar_list", "日本のビジネスカレンダーの全カテ
 // ── Tool: regional_check ────────────────────────────
 server.tool("regional_check", "日本の地域別ビジネス情報を検索します。主要都市の特性、自治体の助成金・補助金、地域条例、商慣習の違い。", {
     query: zod_1.z.string().describe("検索クエリ（例: '大阪の飲食店条例', '東京のスタートアップ助成金'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/regional/check", { query });
     if (!result.category_id) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する地域情報が見つかりませんでした。` }] };
@@ -277,7 +277,7 @@ server.tool("regional_check", "日本の地域別ビジネス情報を検索し
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: regional_list ─────────────────────────────
-server.tool("regional_list", "日本の地域別ビジネス情報の全カテゴリ一覧を取得します。", {}, async () => {
+server.tool("regional_list", "日本の地域別ビジネス情報の全カテゴリ一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/regional/list");
     let text = `🗺️ 地域情報カテゴリ一覧 (${result.count}件):\n\n`;
     for (const c of result.categories) {
@@ -288,7 +288,7 @@ server.tool("regional_list", "日本の地域別ビジネス情報の全カテ
 // ── Tool: organization_check ────────────────────────
 server.tool("organization_check", "日本の組織構造・商慣行を検索します。役職体系、系列、支払慣行、契約慣行、業界団体。", {
     query: zod_1.z.string().describe("検索クエリ（例: '支払いサイトの標準', '契約書の印鑑', '部長と課長の違い'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/organization/check", { query });
     if (!result.category_id) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する組織情報が見つかりませんでした。` }] };
@@ -298,7 +298,7 @@ server.tool("organization_check", "日本の組織構造・商慣行を検索し
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: organization_list ─────────────────────────
-server.tool("organization_list", "日本の組織構造・商慣行の全カテゴリ一覧を取得します。", {}, async () => {
+server.tool("organization_list", "日本の組織構造・商慣行の全カテゴリ一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/organization/list");
     let text = `🏛️ 組織情報カテゴリ一覧 (${result.count}件):\n\n`;
     for (const c of result.categories) {
@@ -309,7 +309,7 @@ server.tool("organization_list", "日本の組織構造・商慣行の全カテ
 // ── Tool: foreign_entry_check ───────────────────────
 server.tool("foreign_entry_check", "外国企業・外国人の日本進出に必要な基盤知識を検索します。法人設立、経営管理ビザ、銀行口座開設、物件探し、税務届出の5カテゴリ。", {
     query: zod_1.z.string().describe("検索クエリ（例: '法人設立の手順', 'ビザ取得', '銀行口座開設'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/foreign-entry/check", { query });
     if (!result.category_id) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する進出情報が見つかりませんでした。` }] };
@@ -326,7 +326,7 @@ server.tool("foreign_entry_check", "外国企業・外国人の日本進出に
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: foreign_entry_list ────────────────────────
-server.tool("foreign_entry_list", "外国企業・外国人の日本進出に関する知識カテゴリの一覧を取得します。", {}, async () => {
+server.tool("foreign_entry_list", "外国企業・外国人の日本進出に関する知識カテゴリの一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/foreign-entry/list");
     let text = `🌐 日本進出カテゴリ一覧 (${result.count}件):\n\n`;
     for (const c of result.categories) {
@@ -337,7 +337,7 @@ server.tool("foreign_entry_list", "外国企業・外国人の日本進出に関
 // ── Tool: travel_search ─────────────────────────────
 server.tool("travel_search", "日本の旅行・観光に関する知識を検索します。交通（新幹線・ICカード・タクシー）、宿泊（旅館マナー・ホテル）、飲食（ラーメン地域差・箸マナー・チップ不要）、実用情報（SIM・ATM・緊急連絡先・マナー）。", {
     query: zod_1.z.string().describe("検索クエリ（例: '新幹線の乗り方', '旅館のマナー', 'ラーメンの食べ方'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/travel/search", { query });
     if (!result.results?.length) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する旅行情報が見つかりませんでした。` }] };
@@ -349,7 +349,7 @@ server.tool("travel_search", "日本の旅行・観光に関する知識を検
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: travel_list ───────────────────────────────
-server.tool("travel_list", "日本の旅行知識のトピック一覧を取得します。", {}, async () => {
+server.tool("travel_list", "日本の旅行知識のトピック一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/travel/list");
     let text = `✈️ 旅行トピック一覧 (${result.total}件):\n\n`;
     for (const t of result.topics) {
@@ -360,7 +360,7 @@ server.tool("travel_list", "日本の旅行知識のトピック一覧を取得
 // ── Tool: entertainment_search ──────────────────────
 server.tool("entertainment_search", "日本のエンターテインメント・ポップカルチャーに関する知識を検索します。推し活（チケット取得・転売法）、アニメ聖地巡礼、ライブマナー（ペンライト・コール）、季節イベント（花見・花火・初詣）。", {
     query: zod_1.z.string().describe("検索クエリ（例: '推し活のチケット購入', 'コミケの参加方法', '花見のマナー'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/entertainment/search", { query });
     if (!result.results?.length) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当するエンタメ情報が見つかりませんでした。` }] };
@@ -372,7 +372,7 @@ server.tool("entertainment_search", "日本のエンターテインメント・
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: entertainment_list ────────────────────────
-server.tool("entertainment_list", "日本のエンタメ知識のトピック一覧を取得します。", {}, async () => {
+server.tool("entertainment_list", "日本のエンタメ知識のトピック一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/entertainment/list");
     let text = `🎭 エンタメトピック一覧 (${result.total}件):\n\n`;
     for (const t of result.topics) {
@@ -383,7 +383,7 @@ server.tool("entertainment_list", "日本のエンタメ知識のトピック一
 // ── Tool: daily_life_search ─────────────────────────
 server.tool("daily_life_search", "日本の日常生活に関する知識を検索します。住所・郵便システム、ゴミ分別ルール、公共料金（電気・ガス・水道・NHK）、医療・健康保険制度。外国人が日本で生活するために必要な実用知識。", {
     query: zod_1.z.string().describe("検索クエリ（例: 'ゴミの分別方法', '健康保険の加入', '引っ越しの手続き'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/daily-life/search", { query });
     if (!result.results?.length) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する日常生活情報が見つかりませんでした。` }] };
@@ -395,7 +395,7 @@ server.tool("daily_life_search", "日本の日常生活に関する知識を検
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: daily_life_list ──────────────────────────
-server.tool("daily_life_list", "日本の日常生活知識のトピック一覧を取得します。", {}, async () => {
+server.tool("daily_life_list", "日本の日常生活知識のトピック一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/daily-life/list");
     let text = `🏠 日常生活トピック一覧 (${result.total}件):\n\n`;
     for (const t of result.topics) {
@@ -406,7 +406,7 @@ server.tool("daily_life_list", "日本の日常生活知識のトピック一覧
 // ── Tool: language_search ──────────────────────────
 server.tool("language_search", "日本語の構造的知識を検索します。敬語体系（尊敬語・謙譲語・丁寧語）、助数詞（数え方）、名前・住所の構造パターン、ビジネス日本語（電話応対・クッション言葉・メールテンプレート）。", {
     query: zod_1.z.string().describe("検索クエリ（例: '敬語の使い方', '助数詞の一覧', 'ビジネスメールの書き方'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/language/search", { query });
     if (!result.results?.length) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する日本語情報が見つかりませんでした。` }] };
@@ -418,7 +418,7 @@ server.tool("language_search", "日本語の構造的知識を検索します。
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: language_list ────────────────────────────
-server.tool("language_list", "日本語知識のトピック一覧を取得します。", {}, async () => {
+server.tool("language_list", "日本語知識のトピック一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/language/list");
     let text = `🗾 日本語トピック一覧 (${result.total}件):\n\n`;
     for (const t of result.topics) {
@@ -429,7 +429,7 @@ server.tool("language_list", "日本語知識のトピック一覧を取得し
 // ── Tool: food_search ──────────────────────────────
 server.tool("food_search", "日本の食文化に関する知識を検索します。食事マナー（箸のタブー・乾杯・割り勘）、料理分類（懐石・定食・ラーメン・郷土料理）、飲食店ガイド（食券機・居酒屋・回転寿司・おまかせ）、アレルギー・食制限（ハラル・ベジタリアン対応）。", {
     query: zod_1.z.string().describe("検索クエリ（例: '箸のマナー', 'ハラル対応レストラン', '回転寿司の注文方法'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/food/search", { query });
     if (!result.results?.length) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する食文化情報が見つかりませんでした。` }] };
@@ -441,7 +441,7 @@ server.tool("food_search", "日本の食文化に関する知識を検索しま
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: food_list ────────────────────────────────
-server.tool("food_list", "日本の食文化知識のトピック一覧を取得します。", {}, async () => {
+server.tool("food_list", "日本の食文化知識のトピック一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/food/list");
     let text = `🍣 食文化トピック一覧 (${result.total}件):\n\n`;
     for (const t of result.topics) {
@@ -452,7 +452,7 @@ server.tool("food_list", "日本の食文化知識のトピック一覧を取得
 // ── Tool: disaster_search ──────────────────────────
 server.tool("disaster_search", "日本の災害・安全に関する知識を検索します。地震（震度スケール・緊急地震速報・耐震基準）、台風・水害（警戒レベル・計画運休）、緊急連絡先（110/119/多言語対応）、防災準備（防災バッグ・ハザードマップ・避難所マナー）。", {
     query: zod_1.z.string().describe("検索クエリ（例: '地震が来たらどうする', '緊急連絡先', '防災バッグの中身'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async ({ query }) => {
     const result = await apiPost("/api/v1/disaster/search", { query });
     if (!result.results?.length) {
         return { content: [{ type: "text", text: `❌ '${query}' に該当する災害・安全情報が見つかりませんでした。` }] };
@@ -464,7 +464,7 @@ server.tool("disaster_search", "日本の災害・安全に関する知識を検
     return { content: [{ type: "text", text }] };
 });
 // ── Tool: disaster_list ────────────────────────────
-server.tool("disaster_list", "日本の災害・安全知識のトピック一覧を取得します。", {}, async () => {
+server.tool("disaster_list", "日本の災害・安全知識のトピック一覧を取得します。", {}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, async () => {
     const result = await apiGet("/api/v1/disaster/list");
     let text = `⚠️ 災害・安全トピック一覧 (${result.total}件):\n\n`;
     for (const t of result.topics) {
@@ -475,7 +475,7 @@ server.tool("disaster_list", "日本の災害・安全知識のトピック一
 // ── Tool: search ────────────────────────────────────
 server.tool("search", "EDITION全14ドメインを横断検索します。1回のリクエストで規制・プロトコル・カレンダー・地域・組織・進出手続き・旅行・エンタメ・日常生活・日本語・食文化・災害安全の全12ドメインを同時検索。", {
     query: zod_1.z.string().describe("検索クエリ（例: '大阪で飲食店を開業', '地震の避難方法', '敬語の使い方'）"),
-}, async ({ query }) => {
+}, { readOnlyHint: true, destructiveHint: false, idempotentHint: true }, 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)) {
@@ -489,6 +489,65 @@ server.tool("search", "EDITION全14ドメインを横断検索します。1回
     }
     return { content: [{ type: "text", text }] };
 });
+// ── Resources ───────────────────────────────────────
+server.resource("domains", "edition://domains", {
+    description: "All 14 knowledge domains with descriptions, endpoints, and coverage status",
+    mimeType: "application/json",
+}, async () => {
+    const domains = [
+        { id: "memory", name: "Persistent Memory", endpoint: "/api/v1/memory", tools: 5, layers: ["rules", "context"] },
+        { id: "regulation", name: "Business Regulations", endpoint: "/api/v1/regulation", tools: 3, layers: ["rules", "context", "experience"] },
+        { id: "protocol", name: "Business Protocols", endpoint: "/api/v1/protocol", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "calendar", name: "Business Calendar", endpoint: "/api/v1/calendar", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "regional", name: "Regional Intelligence", endpoint: "/api/v1/regional", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "organization", name: "Organizational Structures", endpoint: "/api/v1/organization", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "foreign_entry", name: "Foreign Market Entry", endpoint: "/api/v1/foreign-entry", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "travel", name: "Travel Intelligence", endpoint: "/api/v1/travel", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "entertainment", name: "Entertainment & Pop Culture", endpoint: "/api/v1/entertainment", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "daily_life", name: "Daily Life", endpoint: "/api/v1/daily-life", tools: 2, layers: ["rules", "context"] },
+        { id: "language", name: "Japanese Language", endpoint: "/api/v1/language", tools: 2, layers: ["rules", "context"] },
+        { id: "food", name: "Food Culture", endpoint: "/api/v1/food", tools: 2, layers: ["rules", "context", "experience"] },
+        { id: "disaster", name: "Disaster & Safety", endpoint: "/api/v1/disaster", tools: 2, layers: ["rules", "context"] },
+        { id: "search", name: "Cross-Domain Search", endpoint: "/api/v1/search", tools: 1, layers: ["rules", "context", "experience"] },
+    ];
+    return {
+        contents: [
+            {
+                uri: "edition://domains",
+                mimeType: "application/json",
+                text: JSON.stringify({ total: domains.length, total_tools: 31, domains }, null, 2),
+            },
+        ],
+    };
+});
+server.resource("quality", "edition://quality", {
+    description: "Trust Anchor quality scores — verified data coverage, source reliability, and 3-layer completeness for each domain",
+    mimeType: "application/json",
+}, async () => {
+    try {
+        const data = await apiGet("/api/v1/analytics/quality");
+        return {
+            contents: [
+                {
+                    uri: "edition://quality",
+                    mimeType: "application/json",
+                    text: JSON.stringify(data, null, 2),
+                },
+            ],
+        };
+    }
+    catch {
+        return {
+            contents: [
+                {
+                    uri: "edition://quality",
+                    mimeType: "application/json",
+                    text: JSON.stringify({ error: "Quality endpoint unavailable" }),
+                },
+            ],
+        };
+    }
+});
 // ── Start ───────────────────────────────────────────
 async function main() {
     const transport = new stdio_js_1.StdioServerTransport();

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "edition-mcp-server",
-  "version": "0.1.5",
+  "version": "0.2.1",
   "mcpName": "io.github.hiroshic9-png/japan-business-operations",
-  "description": "EDITION Intelligence Platform \u2014 MCP server for Japan operations intelligence (14 knowledge domains, 31 tools)",
+  "description": "EDITION Intelligence Platform — MCP server for Japan operations intelligence. 14 knowledge domains, 31 tools, 2 prompts, 2 resources. Verified ground truth: regulations, procedures, protocols, calendar, regional, organization, foreign entry, travel, entertainment, daily life, language, food culture, disaster safety, and persistent memory.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
@@ -24,8 +24,22 @@
     "travel",
     "entertainment",
     "protocol",
-    "calendar"
+    "calendar",
+    "keigo",
+    "business",
+    "culture",
+    "food",
+    "disaster",
+    "safety",
+    "language",
+    "knowledge-base"
   ],
+  "homepage": "https://edition.sh",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hiroshic9-png/edition-api"
+  },
+  "author": "EDITION <h.sato@c-9.co.jp>",
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1"