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 分