Genji MCP Server

Busca y analiza literatura clásica japonesa usando la API de Genji, con funciones avanzadas de normalización.

GitHubPrueba este MCPPatrocinado

Documentación

Genji MCP Server

npm version

Un servidor de Model Context Protocol (MCP) que proporciona acceso a la API de Genji para el análisis y búsqueda de literatura japonesa clásica. Este servidor permite a asistentes de IA como Claude buscar y analizar textos de la literatura japonesa clásica con funciones avanzadas de normalización.

Características

  • 🏥 Verificación de Salud: Monitorear el estado y la disponibilidad de la API
  • 🔍 Búsqueda Avanzada de Texto: Buscar textos japoneses clásicos con opciones sofisticadas de normalización
  • ⚙️ Reglas de Normalización: Acceder y comprender las reglas de normalización de texto
  • 🔍 Vista Previa de Normalización: Previsualizar cómo se normalizará el texto antes del procesamiento
  • 🇯🇵 Soporte de Japonés Clásico: Manejo especializado de variaciones históricas del texto japonés

Instalación

npm install -g @nakamura196/genji-mcp-server

Configuración

Añade el servidor a tu archivo de configuración de Claude Desktop:

macOS

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "genji": {
      "command": "npx",
      "args": ["@nakamura196/genji-mcp-server"]
    }
  }
}

Windows

Edita %APPDATA%/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "genji": {
      "command": "npx",
      "args": ["@nakamura196/genji-mcp-server"]
    }
  }
}

Alternativamente, si lo instalaste globalmente:

{
  "mcpServers": {
    "genji": {
      "command": "genji-mcp-server"
    }
  }
}

Uso

Después de la configuración, reinicia Claude Desktop. Las herramientas de Genji estarán disponibles automáticamente. Puedes pedirle a Claude análisis de literatura japonesa clásica como:

Verificación de Salud

  • "Comprueba si la API de Genji está funcionando"
  • "¿Está disponible la base de datos de literatura japonesa clásica?"

Búsqueda de Texto

  • "Busca '花' en textos japoneses clásicos"
  • "Encuentra pasajes que contengan '源氏' con normalización fonética"
  • "Busca texto en el volumen 1 de Genji Monogatari"
  • "Busca '恋' con todas las opciones de normalización habilitadas"

Funciones de Normalización

  • "¿Qué reglas de normalización están disponibles para el japonés clásico?"
  • "Previsualiza cómo se normalizaría '源氏物語'"
  • "Muéstrame las reglas de normalización para el kana histórico"

Herramientas Disponibles

genji_health_check

Comprueba el estado y la disponibilidad de la API de Genji.

Parámetros: Ninguno

genji_search

Busca textos japoneses clásicos con opciones avanzadas de normalización.

Parámetros:

  • query (string, opcional): Texto de la consulta de búsqueda
  • limit (number, opcional): Número máximo de resultados a devolver (1-100, predeterminado: 20)
  • offset (number, opcional): Número de resultados a omitir (predeterminado: 0)
  • sort (string, opcional): Orden de clasificación de los resultados
  • expand_repeat_marks (boolean, opcional): Expandir marcas de repetición (predeterminado: true)
  • unify_kanji_kana (boolean, opcional): Unificar variaciones de kanji/kana (predeterminado: true)
  • unify_historical_kana (boolean, opcional): Unificar kana histórico (predeterminado: true)
  • unify_phonetic_changes (boolean, opcional): Unificar variaciones fonéticas (predeterminado: true)
  • unify_dakuon (boolean, opcional): Unificar variaciones de sonidos sonoros (predeterminado: true)
  • vol_str (array, opcional): Filtro de volumen/capítulo

genji_get_normalization_rules

Recupera la lista de reglas de normalización de texto disponibles.

Parámetros: Ninguno

genji_preview_normalization

Previsualiza cómo se normalizaría el texto con las reglas actuales.

Parámetros:

  • text (string, obligatorio): Texto para previsualizar su normalización

Funciones de Normalización de Texto

El servidor admite varias opciones de normalización para texto japonés clásico:

  • Expansión de Marcas de Repetición: Convierte marcas de repetición (々, ゝ, ゞ) en caracteres completos
  • Unificación Kanji-Kana: Maneja variaciones entre representaciones en kanji y kana
  • Unificación de Kana Histórico: Normaliza el uso del kana histórico a equivalentes modernos
  • Cambios Fonéticos: Tiene en cuenta variaciones fonéticas históricas
  • Unificación de Dakuon: Maneja variaciones de sonidos sonoros/sordos

Requisitos

Desarrollo

# 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

Referencia de la API

Este servidor se integra con la API de Genji, que proporciona:

  • Búsqueda de texto completo de literatura japonesa clásica
  • Normalización avanzada de texto para japonés histórico
  • Metadatos sobre obras literarias y volúmenes
  • Puntos finales de monitoreo de salud

Manejo de Errores

El servidor incluye un manejo integral de errores para:

  • Problemas de conectividad con la API
  • Parámetros de búsqueda no válidos
  • Problemas de codificación de texto
  • Errores de normalización
  • Limitación de velocidad (si corresponde)

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Pull Request.

Licencia

Licencia MIT: consulta el archivo LICENSE para obtener más detalles.

Soporte

Si encuentras algún problema, por favor repórtalo en la página de GitHub Issues.

Proyectos Relacionados

Registro de Cambios

1.0.1

  • Corregir referencias de URL de API en la documentación
  • Eliminar interfaces TypeScript no utilizadas para un código más limpio
  • Actualizar enlaces de documentación

1.0.0

  • Lanzamiento inicial
  • Funcionalidad de verificación de salud
  • Búsqueda avanzada de texto con opciones de normalización
  • Gestión de reglas de normalización
  • Vista previa de normalización de texto
  • Soporte completo de análisis de texto japonés clásico