Edition Api

io.github.hiroshic9-png由 GitHub 帳號 hiroshic9-png 發布v0.3.1更新於 Oct 24, 2026

Japan business regulations, compliance, travel, protocols, memory — 10 knowledge domains, 23 tools.

已驗證STDIO僅桌面位置與生活知識與記憶商業與電商

概覽

AI 產生的概覽

本機 MCP 伺服器，為助理提供結構化的日本知識：法規、商務禮儀、旅遊、日常生活，以及橫跨 20 個領域的日語感知記憶。

可以做什麼
查詢 10 個產業的法規與旅客合規要求，並為已執行的法規檢查記錄稽核日誌、產生治理報告。檢索日本的商務禮儀、行事曆、地區差異、組織結構與外資進入指南。搜尋生活與文化主題：旅遊、飲食娛樂、日常生活、語言、災害安全、醫療、教育、房地產、稅務、銀行與簽證。儲存、召回並擷取持久記憶的片段、事實與脈絡，含日語敬語與階層分析。用一次跨領域搜尋同時涵蓋全部 20 個領域。
適用情境
適合助理需要回答在日本經營或生活的問題時使用，例如公司設立、簽證、產業監管、商務禮節或日常事務，並希望答案基於結構化條目而非通用模型知識。也適合需要日語感知持久記憶或合規稽核紀錄的代理。
執行需求
透過 npx（Node.js）以 stdio 程序在本機執行，也可經由託管 API 存取。需要能連線 EDITION API 基礎位址（EDITION_API_URL）的網路，並在 EDITION_API_KEY 中提供 API 金鑰；預設提供免費測試金鑰。免費層僅含 8 個核心領域、每天 100 次請求；全部 20 個領域需付費 Pro 方案。
安裝前請注意
API 金鑰是機密，透過環境變數傳入，請勿寫入共用設定檔。免費層僅限 8 個領域和每天 100 次請求，完整存取為付費訂閱。記憶工具會把儲存的片段與事實寫入服務，對話內容會傳送到第三方 API。合規日誌與報告工具會建立紀錄，依賴前請確認其持久化內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Edition Api，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

EDITION Intelligence Platform

[Glama Score] [npm] [License: MIT]

Japan Knowledge Gateway for autonomous AI agents.

20 knowledge domains · 43 MCP tools · 7 Skills Packs · 100+ REST endpoints Verified ground truth for operating in the Japanese market. Quality score: 97.8/100.

Production API: api.edition.sh — Free beta, no registration required.

Interactive Demo: Tourist Agent Demo — Watch 6 domains work together in real-time.

Why EDITION?

AI agents working in Japan hit walls that generic LLMs can't solve:

ChallengeWhat goes wrong
Keigo (敬語)「お持ちすれば喜ばれるかと存じます」 — hidden subject, layered honorifics, uncertainty expression. Generic NLP treats this as noise.
Implicit agreementsJapanese business communication rarely states things directly. Agents need cultural decoding.
Regulatory maze10+ industries with overlapping national/prefectural regulations, most documentation only in Japanese.
Procedural complexityCompany incorporation, visa, banking — each requires 5-8 steps with specific documents, deadlines, and costs.

EDITION provides verified, structured intelligence that agents can use as ground truth instead of hallucinating cultural nuances, legal requirements, and procedural details.

20 Knowledge Domains

#DomainToolsWhat it covers
1Memorymemory_store memory_recall memory_facts memory_context memory_extractThree-layer persistent memory (Episode/Fact/Context) with Japanese keigo analysis and social hierarchy detection
2Regulationregulation_check regulation_industries regulation_tourist10 industries (food, real estate, finance, healthcare, construction, education, transport, retail, IT, manufacturing) + tourist compliance
3Protocolprotocol_check protocol_listNemawashi, ringi, hourensou, meishi koukan, sekijun, zoutou — step-by-step procedures with cultural context
4Calendarcalendar_check calendar_listFiscal year (April start), Golden Week, Obon, year-end, gift seasons, administrative deadlines
5Regionalregional_check regional_listTokyo vs Osaka negotiation styles, local subsidies, prefectural regulations, dialect considerations
6Organizationorganization_check organization_listKeiretsu networks, corporate hierarchy (bucho/kacho), payment customs (net-60), contract practices
7Foreign Entryforeign_entry_check foreign_entry_list6 categories: company incorporation (KK/GK), management visa, bank account, real estate, tax registration, employee hiring
8Traveltravel_search travel_listShinkansen, IC cards, ryokan etiquette, onsen rules, restaurant ordering, tipping customs
9Entertainmententertainment_search entertainment_listOshi-katsu fan culture, anime pilgrimage, live event manners, seasonal festivals
10Daily Lifedaily_life_search daily_life_listPostal/address systems, garbage sorting by municipality, utilities (electricity/gas/water/NHK), healthcare navigation
11Languagelanguage_search language_listKeigo honorific system, counter words (josushi), name/address structure, business Japanese templates
12Food Culturefood_search food_listDining etiquette, cuisine classification, restaurant navigation (shokkenki, izakaya, sushi counter), dietary restrictions (halal, vegetarian, allergies)
13Disaster & Safetydisaster_search disaster_listEarthquake shindo scale & EEW, typhoon warning levels, emergency contacts (110/119/118), preparedness checklists
14Healthcarehealthcare_search healthcare_listNational health insurance, hospital navigation, prescription system, medical Japanese terminology
15Educationeducation_search education_listSchool system (6-3-3-4), entrance exams, international schools, university admission for foreigners
16Real Estatereal_estate_search real_estate_listRental process (shikikin/reikin/hoshoukin), property types, foreigner-friendly agencies, contract terms
17Taxtax_search tax_listIncome tax, consumption tax, withholding, year-end adjustment, tax filing for foreigners and businesses
18Banking & Financebanking_search banking_listBank account types, remittance, fintech services, corporate banking, payment systems
19Visa & Immigrationvisa_search visa_listVisa categories, status of residence, renewal procedures, permanent residency, naturalization
20Cross-DomainsearchSearch all 20 domains simultaneously with a single query

Skills Packs (MCP Skills Primitive)

Pre-built knowledge packs that bundle domain expertise, SOPs, and tool orchestration instructions. Skills-aware agents can load these to gain structured Japan operational knowledge.

Skill PackDomainsUse Case
japan-market-entryregulation, foreign_entry, organizationCompany incorporation, visa, banking
japan-business-opsprotocol, calendar, regional, languageMeetings, nemawashi, business Japanese
japan-travel-guidetravel, food, entertainment, disasterTourist assistance, dining, safety
japan-daily-livingdaily_life, food, languageUtilities, garbage, healthcare
japan-cultural-contextprotocol, organization, languageImplicit communication, hierarchy
japan-safety-compliancedisaster, regulationEarthquake response, regulatory compliance
japan-governance-complianceregulation, governanceAudit trails, compliance reporting, AI Act readiness

→ Full Skills Pack documentation

Governance Intelligence

EDITION includes built-in compliance audit trail tools for agents operating under governance requirements. Available in both Progressive Discovery and Legacy modes.

regulation_check → compliance_log → compliance_report      ↓                   ↓                  ↓  Check rules      Record audit       Generate report
ToolPurpose
compliance_logCreate immutable, timestamped audit record after any regulatory check
compliance_reportGenerate governance reports (summary / detailed / JSON) from audit trail

Designed for EU AI Act (Aug 2026) and upcoming Japan AI governance compliance.

Quick Start

Option 1: npx (Recommended for Claude Desktop / Cursor)

bash
npx -y edition-mcp-server

Add to claude_desktop_config.json:

json
{  "mcpServers": {    "edition": {      "command": "npx",      "args": ["-y", "edition-mcp-server"],      "env": {        "EDITION_API_URL": "https://api.edition.sh",        "EDITION_API_KEY": "edition_dev_key_for_testing"      }    }  }}

Option 2: Smithery

bash
npx -y smithery mcp add hiroshi-c9/edition

Option 3: REST API (Direct)

bash
# Cross-domain searchcurl -X POST https://api.edition.sh/api/v1/search \  -H "Content-Type: application/json" \  -d '{"query": "How do I start a tech company in Tokyo?"}'
# Regulation checkcurl -X POST https://api.edition.sh/api/v1/regulation/check \  -d '{"action": "open restaurant", "industry": "food_service"}'
# Business protocolcurl -X POST https://api.edition.sh/api/v1/protocol/check \  -d '{"query": "nemawashi consensus building"}'

Memory API — Japanese-aware Persistent Memory

Store episodes, auto-extract structured facts with keigo analysis, social hierarchy detection, and confidence scoring.

Input:  "佐藤部長にはワインをお持ちすれば喜ばれるかと存じます"
Output:  Subject:    佐藤 (役職: 部長)  Predicate:  好む  Object:     ワイン  Keigo:      Level 2 (尊敬語)  Hierarchy:  superior  Confidence: 0.7 (推測 — not stated as fact)  Tense:      present

Three-layer architecture:

  • Episodes — raw conversation logs
  • Facts — structured knowledge (subject→predicate→object triples)
  • Context — aggregated session summaries per entity/topic

MCP Capabilities

CategoryCountDetails
Tools43All with annotations (readOnlyHint, destructiveHint, idempotentHint)
Resources2edition://domains (domain catalog), edition://quality (trust scores)
Prompts2japan_business_briefing (by industry), japan_travel_guide (by destination)

API Endpoints

Memory

MethodEndpointDescription
POST/api/v1/memory/episodesStore episode (auto_extract=true for auto fact extraction)
POST/api/v1/memory/recallSemantic search across episodes
GET/api/v1/memory/factsList structured facts
GET/api/v1/memory/contextSession context summary
POST/api/v1/memory/extractExtract facts from text (store=true to persist)

Regulation & Compliance

MethodEndpointDescription
POST/api/v1/regulation/checkCheck regulations (10 industries + tourist)
GET/api/v1/regulation/industriesList all regulated industries
GET/api/v1/regulation/touristTourist regulation categories

Business Intelligence

MethodEndpointDescription
POST/api/v1/protocol/checkSearch business protocols
GET/api/v1/protocol/listList all protocols
POST/api/v1/calendar/checkSearch business calendar
GET/api/v1/calendar/listList calendar categories
POST/api/v1/regional/checkSearch regional differences
GET/api/v1/regional/listList regional categories
POST/api/v1/organization/checkSearch organizational structures
GET/api/v1/organization/listList organization categories

Market Entry

MethodEndpointDescription
POST/api/v1/foreign-entry/checkForeign market entry guides
GET/api/v1/foreign-entry/listList entry categories (6 total)

Lifestyle & Culture

MethodEndpointDescription
POST/api/v1/travel/searchTravel intelligence
POST/api/v1/entertainment/searchEntertainment & pop culture
POST/api/v1/daily-life/searchDaily life knowledge
POST/api/v1/language/searchJapanese language
POST/api/v1/food/searchFood culture
POST/api/v1/disaster/searchDisaster & safety
POST/api/v1/healthcare/searchHealthcare system
POST/api/v1/education/searchEducation system
POST/api/v1/real-estate/searchReal estate
POST/api/v1/tax/searchTax system
POST/api/v1/banking/searchBanking & finance
POST/api/v1/visa/searchVisa & immigration

Cross-Domain

MethodEndpointDescription
POST/api/v1/searchSearch all 20 domains simultaneously

Data Quality

All knowledge entries include:

  • source_url — Link to authoritative source (government websites, official organizations)
  • last_verified — Date of last verification
  • confidence — Verification status (verified / estimated)
  • version — Entry version with changelog

Sources include: 厚生労働省 (MHLW), 国税庁 (NTA), 法務省 (MOJ), 国土交通省 (MLIT), 経済産業省 (METI), 日本経団連 (Keidanren), JETRO, 入管庁 (ISA).

Tech Stack

LayerTechnology
APIFastAPI (Python)
Memory StoreSQLite + ChromaDB (vector search)
MCP ServerTypeScript (MCP SDK v1.12+)
LLMGemini / Claude / GPT (fact extraction)
HostingRender (api.edition.sh)

Agent Discovery

ProtocolEndpoint
MCP (Streamable HTTP)POST https://api.edition.sh/mcp
A2A Agent CardGET https://api.edition.sh/.well-known/agent.json
MCP Server CardGET https://api.edition.sh/.well-known/mcp/server-card.json
OpenAPI / SwaggerGET https://api.edition.sh/docs

Agent Harness Compatible

EDITION is designed as a Tool Registry / Japan Knowledge Layer for agent harnesses. All 43 tools include MCP annotations (readOnlyHint, destructiveHint, idempotentHint), usage guidelines, and behavioral transparency metadata — enabling harness frameworks to auto-discover, evaluate, and integrate EDITION tools without manual configuration.

Freemium Access

TierDomainsRate LimitPrice
Free8 core domains100 req/dayFree
ProAll 20 domains (incl. tax, banking, healthcare, visa)10,000 req/day¥2,980/mo
EnterpriseAll domains + priority supportUnlimitedContact

Anonymous access defaults to Free tier. Register for an API key at POST /api/v1/auth/register.

Registries

RegistryStatus
npm✅ Published (v0.4.0)
Smithery✅ Listed (43 tools)
Glama✅ Grade A Coherence

Why Not Mem0 / Letta / Zep?

Those are excellent general-purpose memory tools. But they don't:

  • Parse Japanese keigo levels (丁寧語 / 尊敬語 / 謙譲語)
  • Detect implicit social hierarchy from honorific patterns
  • Score confidence based on Japanese speech patterns (断定 vs 推測 vs 伝聞)
  • Include a Japanese regulatory database with 20 knowledge domains

Japanese business context is structurally different. Agents need purpose-built infrastructure to navigate it.

License

MIT

來源：README.md，提交 74b8cc9

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.3.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分