Genji MCP Server

Pesquise e analise literatura clássica japonesa usando a API Genji, com recursos avançados de normalização.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor Genji MCP

npm version

Um servidor Model Context Protocol (MCP) que fornece acesso à API Genji para análise e busca de literatura clássica japonesa. Este servidor permite que assistentes de IA como o Claude pesquisem e analisem textos da literatura clássica japonesa com recursos avançados de normalização.

Recursos

  • 🏥 Verificação de Saúde: Monitore o status e a disponibilidade da API
  • 🔍 Busca Avançada de Texto: Pesquise textos clássicos japoneses com opções sofisticadas de normalização
  • ⚙️ Regras de Normalização: Acesse e entenda as regras de normalização de texto
  • 🔍 Pré-visualização de Normalização: Veja como o texto será normalizado antes do processamento
  • 🇯🇵 Suporte a Japonês Clássico: Tratamento especializado de variações históricas de texto japonês

Instalação

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

Configuração

Adicione o servidor ao seu arquivo de configuração do Claude Desktop:

macOS

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

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

Windows

Edite %APPDATA%/Claude/claude_desktop_config.json:

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

Alternativamente, se você instalou globalmente:

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

Uso

Após a configuração, reinicie o Claude Desktop. As ferramentas Genji estarão automaticamente disponíveis. Você pode pedir ao Claude análises de literatura clássica japonesa como:

Verificação de Saúde

  • "Verifique se a API Genji está funcionando"
  • "O banco de dados de literatura clássica japonesa está disponível?"

Busca de Texto

  • "Pesquise por '花' em textos clássicos japoneses"
  • "Encontre passagens contendo '源氏' com normalização fonética"
  • "Pesquise texto no volume 1 de Genji Monogatari"
  • "Procure por '恋' com todas as opções de normalização habilitadas"

Recursos de Normalização

  • "Quais regras de normalização estão disponíveis para japonês clássico?"
  • "Pré-visualize como '源氏物語' seria normalizado"
  • "Mostre-me as regras de normalização para kana histórico"

Ferramentas Disponíveis

genji_health_check

Verifica a saúde e a disponibilidade da API Genji.

Parâmetros: Nenhum

genji_search

Pesquisa textos clássicos japoneses com opções avançadas de normalização.

Parâmetros:

  • query (string, opcional): Texto da consulta de busca
  • limit (número, opcional): Número máximo de resultados a retornar (1-100, padrão: 20)
  • offset (número, opcional): Número de resultados a pular (padrão: 0)
  • sort (string, opcional): Ordem de classificação dos resultados
  • expand_repeat_marks (booleano, opcional): Expandir marcas de repetição (padrão: true)
  • unify_kanji_kana (booleano, opcional): Unificar variações de kanji/kana (padrão: true)
  • unify_historical_kana (booleano, opcional): Unificar kana histórico (padrão: true)
  • unify_phonetic_changes (booleano, opcional): Unificar variações fonéticas (padrão: true)
  • unify_dakuon (booleano, opcional): Unificar variações de sons sonoros (padrão: true)
  • vol_str (array, opcional): Filtro de volume/capítulo

genji_get_normalization_rules

Recupera a lista de regras de normalização de texto disponíveis.

Parâmetros: Nenhum

genji_preview_normalization

Pré-visualiza como o texto seria normalizado com as regras atuais.

Parâmetros:

  • text (string, obrigatório): Texto para pré-visualizar a normalização

Recursos de Normalização de Texto

O servidor suporta várias opções de normalização para texto japonês clássico:

  • Expansão de Marcas de Repetição: Converte marcas de repetição (々, ゝ, ゞ) em caracteres completos
  • Unificação Kanji-Kana: Trata variações entre representações em kanji e kana
  • Unificação de Kana Histórico: Normaliza o uso de kana histórico para equivalentes modernos
  • Mudanças Fonéticas: Considera variações fonéticas históricas
  • Unificação de Dakuon: Trata variações de sons sonoros/surdos

Requisitos

Desenvolvimento

# 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

Referência da API

Este servidor faz interface com a API Genji, que fornece:

  • Busca em texto completo de literatura clássica japonesa
  • Normalização avançada de texto para japonês histórico
  • Metadados sobre obras literárias e volumes
  • Endpoints de monitoramento de saúde

Tratamento de Erros

O servidor inclui tratamento abrangente de erros para:

  • Problemas de conectividade com a API
  • Parâmetros de busca inválidos
  • Problemas de codificação de texto
  • Erros de normalização
  • Limitação de taxa (se aplicável)

Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Suporte

Se você encontrar problemas, por favor registre-os na página de Issues do GitHub.

Projetos Relacionados

Registro de Alterações

1.0.1

  • Corrigir referências de URL da API na documentação
  • Remover interfaces TypeScript não utilizadas para código mais limpo
  • Atualizar links da documentação

1.0.0

  • Lançamento inicial
  • Funcionalidade de verificação de saúde
  • Busca avançada de texto com opções de normalização
  • Gerenciamento de regras de normalização
  • Pré-visualização de normalização de texto
  • Suporte completo à análise de texto clássico japonês