Genji MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Genji MCP Server search for 'moon' in classical Japanese texts with all normalization options"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Genji MCP Server
A Model Context Protocol (MCP) server that provides access to the Genji API for classical Japanese literature analysis and search. This server enables AI assistants like Claude to search and analyze texts from classical Japanese literature with advanced normalization features.
Features
🏥 Health Check: Monitor API status and availability
🔍 Advanced Text Search: Search classical Japanese texts with sophisticated normalization options
⚙️ Normalization Rules: Access and understand text normalization rules
🔍 Normalization Preview: Preview how text will be normalized before processing
🇯🇵 Classical Japanese Support: Specialized handling of historical Japanese text variations
Related MCP server: @codeagentjp/law-diff-mcp
Installation
npm install -g @nakamura196/genji-mcp-serverConfiguration
Add the server to your Claude Desktop configuration file:
macOS
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"genji": {
"command": "npx",
"args": ["@nakamura196/genji-mcp-server"]
}
}
}Windows
Edit %APPDATA%/Claude/claude_desktop_config.json:
{
"mcpServers": {
"genji": {
"command": "npx",
"args": ["@nakamura196/genji-mcp-server"]
}
}
}Alternatively, if you installed globally:
{
"mcpServers": {
"genji": {
"command": "genji-mcp-server"
}
}
}Usage
After configuration, restart Claude Desktop. The Genji tools will be automatically available. You can ask Claude for classical Japanese literature analysis like:
Health Check
"Check if the Genji API is working"
"Is the classical Japanese literature database available?"
Text Search
"Search for '花' in classical Japanese texts"
"Find passages containing '源氏' with phonetic normalization"
"Search for text in volume 1 of Genji Monogatari"
"Look for '恋' with all normalization options enabled"
Normalization Features
"What normalization rules are available for classical Japanese?"
"Preview how '源氏物語' would be normalized"
"Show me the normalization rules for historical kana"
Available Tools
genji_health_check
Checks the health and availability of the Genji API.
Parameters: None
genji_search
Searches classical Japanese texts with advanced normalization options.
Parameters:
query(string, optional): Search query textlimit(number, optional): Maximum results to return (1-100, default: 20)offset(number, optional): Number of results to skip (default: 0)sort(string, optional): Sort order for resultsexpand_repeat_marks(boolean, optional): Expand repeat marks (default: true)unify_kanji_kana(boolean, optional): Unify kanji/kana variations (default: true)unify_historical_kana(boolean, optional): Unify historical kana (default: true)unify_phonetic_changes(boolean, optional): Unify phonetic variations (default: true)unify_dakuon(boolean, optional): Unify voiced sound variations (default: true)vol_str(array, optional): Volume/chapter filter
genji_get_normalization_rules
Retrieves the list of available text normalization rules.
Parameters: None
genji_preview_normalization
Previews how text would be normalized with current rules.
Parameters:
text(string, required): Text to preview normalization for
Text Normalization Features
The server supports various normalization options for classical Japanese text:
Repeat Marks Expansion: Converts repeat marks (々, ゝ, ゞ) to full characters
Kanji-Kana Unification: Handles variations between kanji and kana representations
Historical Kana Unification: Normalizes historical kana usage to modern equivalents
Phonetic Changes: Accounts for historical phonetic variations
Dakuon Unification: Handles voiced/unvoiced sound variations
Requirements
Node.js 16.0.0 or higher
Internet connection for API access
Access to the Genji API (https://genji-api.aws.ldas.jp)
Development
# Clone the repository
git clone https://github.com/nakamura196/genji-mcp-server.git
cd genji-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
# Start in development mode
npm run devAPI Reference
This server interfaces with the Genji API, which provides:
Full-text search of classical Japanese literature
Advanced text normalization for historical Japanese
Metadata about literary works and volumes
Health monitoring endpoints
Error Handling
The server includes comprehensive error handling for:
API connectivity issues
Invalid search parameters
Text encoding problems
Normalization errors
Rate limiting (if applicable)
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT License - see the LICENSE file for details.
Support
If you encounter any issues, please file them on the GitHub Issues page.
Related Projects
Genji API - The underlying API for classical Japanese literature
Model Context Protocol - The protocol this server implements
Changelog
1.0.1
Fix API URL references in documentation
Remove unused TypeScript interfaces for cleaner code
Update documentation links
1.0.0
Initial release
Health check functionality
Advanced text search with normalization options
Normalization rules management
Text normalization preview
Full classical Japanese text analysis support
Available Tools
4 toolsgenji_get_normalization_rulesB
Get the list of available text normalization rules
Inputs: no named parameters.
genji_health_checkB
Check the health status of the Genji API
Inputs: no named parameters.
genji_preview_normalizationC
Preview how text would be normalized with current rules
Inputs: text (required).
genji_searchC
Search classical Japanese texts with advanced normalization options
Inputs: query, limit, offset, sort, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose with no overlap: getting rules, health checks, previewing normalization, and searching texts. The descriptions make it easy to differentiate between configuration, monitoring, testing, and core functionality.
All tools follow a consistent 'genji_verb_noun' pattern with snake_case throughout. The naming is predictable and readable, making it easy to understand each tool's function at a glance.
Four tools is well-scoped for a server focused on text normalization and search in classical Japanese texts. Each tool earns its place by covering distinct aspects: configuration, health, preview, and core search functionality.
The toolset covers the essential workflows for text normalization and search, but there are minor gaps such as updating or managing normalization rules beyond just getting them. However, agents can work effectively with the provided tools for most use cases.
Maintenance
Related MCP Connectors
Authoritative JLPT-graded Japanese dataset (kanji, vocab, grammar, history) via MCP and REST.
Normalize and romanize Japanese addresses, look up postal codes, count Japanese business days.
Japanese national holidays, business days and wareki (era) dates, exact not guessed. No API key.
Search Japanese statutes via the e-Gov Law API. Free law_search tool.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables intelligent search and retrieval of Japanese legal statutes through the e-Gov API. Supports smart lookup of laws and articles with abbreviation recognition, batch processing, and multi-tier caching for high-performance legal research.815MIT
- AlicenseNot gradedqualityCmaintenanceEnables finding Japanese e-Gov law revisions and diffing law text by law history ID.MIT
- AlicenseBqualityCmaintenanceEnables read-only search and exploration of the GenizahSearch research API, including manuscript search, page browsing, parallel finding, and multi-phrase queries, along with policy resources and research prompts.4Creative Commons Attribution Non Commercial Share Alike 4.0 International
- AlicenseNot gradedqualityBmaintenanceEnables full-text search and retrieval of Kansallisarkisto's machine-transcribed archival corpora, including medieval charters from Diplomatarium Fennicum, with filters and stemming support.Apache 2.0