edition-mcp-server 0.2.0 → 0.2.1

package/dist/index.js

@@ -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)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edition-mcp-server",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "mcpName": "io.github.hiroshic9-png/japan-business-operations",
   "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",