Skip to main content
Glama
Genji MCP Server

Genji MCP Server

by nakamura196

Genji MCP Server

npm version

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-server

Configuration

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?"

  • "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

Searches classical Japanese texts with advanced normalization options.

Parameters:

  • query (string, optional): Search query text

  • limit (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 results

  • expand_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

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 dev

API 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.

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 tools
genji_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).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables 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.
      8
      15
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      4
      Creative Commons Attribution Non Commercial Share Alike 4.0 International
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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