oyemi-mcp

Oyemi MCP Server

Servidor MCP (Model Context Protocol) para o léxico semântico Oyemi. Fornece mapeamento determinístico de palavra para código e análise de valência para agentes de IA como Claude, ChatGPT e Gemini.

Recursos

• Codificação Semântica: Converta palavras em códigos semânticos determinísticos
• Análise de Valência: Analise o sentimento do texto usando valência baseada em léxico
• Similaridade Semântica: Meça o quão semelhantes duas palavras são
• Consulta de Sinônimos/Antônimos: Encontre palavras relacionadas
• Zero Dependências em Tempo de Execução: Nenhuma biblioteca externa de PLN necessária em tempo de execução

Instalação

pip install oyemi-mcp

Ou instale a partir do código-fonte:

git clone https://github.com/Osseni94/oyemi-mcp
cd oyemi-mcp
pip install -e .

Configuração

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "oyemi": {
      "command": "oyemi-mcp"
    }
  }
}

Claude Code

Adicione às suas configurações MCP:

{
  "mcpServers": {
    "oyemi": {
      "command": "oyemi-mcp"
    }
  }
}

Ferramentas Disponíveis

encode_word

Codifique uma palavra para seu código semântico.

encode_word("happy")
-> {
    "word": "happy",
    "code": "1023-00012-3-2-1",
    "pos": "adjective",
    "abstractness": "abstract",
    "valence": "positive"
}

analyze_text

Analise a valência/sentimento do texto.

analyze_text("I feel hopeful but anxious about the future")
-> {
    "valence_score": 0.0,
    "sentiment": "neutral",
    "positive_words": ["hopeful"],
    "negative_words": ["anxious"],
    ...
}

semantic_similarity

Compare duas palavras semanticamente.

semantic_similarity("happy", "joyful")
-> {
    "similarity": 0.85,
    "relationship": "very similar"
}

find_synonyms

Encontre sinônimos para uma palavra.

find_synonyms("happy")
-> {
    "synonyms": ["glad", "felicitous", "well-chosen"]
}

find_antonyms

Encontre antônimos para uma palavra.

find_antonyms("happy")
-> {
    "antonyms": ["unhappy"]
}

batch_encode

Codifique várias palavras de uma vez.

batch_encode(["happy", "sad", "neutral"])
-> {
    "results": [
        {"word": "happy", "valence": "positive"},
        {"word": "sad", "valence": "negative"},
        {"word": "neutral", "valence": "neutral"}
    ]
}

get_lexicon_info

Obtenha informações sobre o léxico.

get_lexicon_info()
-> {
    "name": "Oyemi",
    "version": "3.2.0",
    "word_count": 145014
}

Formato do Código

Os códigos Oyemi seguem o formato HHHH-LLLLL-P-A-V:

Componente	Descrição	Valores
HHHH	Superclasse semântica	Código de categoria de 4 dígitos
LLLLL	ID do Synset	Identificador único de 5 dígitos
P	Classe gramatical	1=substantivo, 2=verbo, 3=adjetivo, 4=advérbio
A	Abstração	0=concreto, 1=misto, 2=abstrato
V	Valência	0=neutro, 1=positivo, 2=negativo

Casos de Uso

• Análise de Sentimento com IA: Permita que agentes de IA entendam o tom emocional
• Fundamentação Semântica: Forneça pontuações concretas de valência em vez de adivinhar
• Análise de Texto: Analise documentos, avaliações, feedback
• Relações entre Palavras: Encontre sinônimos, antônimos, palavras semelhantes

Licença

MIT License

Autor

Kaossara Osseni - grandnasser.com