English Français العربية

terminologia

Registre officiel Autres

Cliente MCP para consultar terminologias de saúde da Voa.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

PYPI package terminologia
Claude Code 
claude mcp add terminologia -e 'TERMINOLOGIA_KEY=<your terminologia_key>' -e 'TERMINOLOGIA_URL=<TERMINOLOGIA_URL>' -- uvx terminologia==0.1.1 mcp
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "terminologia": {
            "command": "uvx",
            "args": [
                "terminologia==0.1.1",
                "mcp"
            ],
            "env": {
                "TERMINOLOGIA_KEY": "<your terminologia_key>",
                "TERMINOLOGIA_URL": "<TERMINOLOGIA_URL>"
            }
        }
    }
}

Variables d'environnement

  • TERMINOLOGIA_KEY obligatoire secret Chave de produto da organização (sk_voa_) com escopo terminology:read.
  • TERMINOLOGIA_URL URL base FHIR; substitui o endpoint padrão.

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. terminologia
  2. Início rápido
  3. CLI
  4. Conectar agentes
  5. Sistemas
  6. Atribuição
  7. Erros
  8. terminologia ou tiss.tuss?
  9. Licença

Documentação · tiss

terminologia

Cliente Python e ferramentas MCP para consultar CID-10, CIAP-2, TUSS, SIGTAP, ANVISA, CBO, LOINC, UCUM e outros sistemas de terminologia em FHIR.

Início rápido

pip install terminologia

Crie uma chave de produto da organização em https://tiss-api.voa.health/org e configure:

export TERMINOLOGIA_KEY=sk_voa_...

Chaves sk_tiss_ existentes também podem ser usadas quando possuem o escopo terminology:read.

import terminologia

resultado = terminologia.cid10.buscar("dor torácica")
for conceito in resultado:
    print(conceito.coding())

consulta = terminologia.tuss.lookup("10101012")
if consulta:
    print(consulta.display)

CLI

ComandoUso
terminologia buscar <sistema> <texto> [-n N]Buscar conceitos
terminologia lookup <sistema> <código>Consultar um código
terminologia validar <sistema> <código>Validar um código
terminologia traduzir <sistema> <código> [--para SISTEMA]Traduzir um código
terminologia sistemasListar os sistemas
terminologia mcpIniciar o servidor MCP local

Use --json nos comandos, exceto mcp, para receber JSON. O código de saída é 0 para sucesso, 1 quando não há resultado ou o código é inválido e 2 para erros de uso, chave, acesso, cota, rede ou servidor.

Conectar agentes

Claude Code:

claude mcp add terminologia -e TERMINOLOGIA_KEY=sk_voa_... -- \
  uvx --from "terminologia[mcp]" terminologia mcp

Codex (~/.codex/config.toml):

[mcp_servers.terminologia]
command = "uvx"
args = ["--from", "terminologia[mcp]", "terminologia", "mcp"]

[mcp_servers.terminologia.env]
TERMINOLOGIA_KEY = "sk_voa_..."

Cursor (mcp.json):

{
  "mcpServers": {
    "terminologia": {
      "command": "uvx",
      "args": ["--from", "terminologia[mcp]", "terminologia", "mcp"],
      "env": {
        "TERMINOLOGIA_KEY": "sk_voa_..."
      }
    }
  }
}

Sistemas

NomeCanônico
cid10http://hl7.org/fhir/sid/icd-10
ciap2http://hl7.org/fhir/sid/icpc-2
tusshttps://voa.health/fhir/CodeSystem/tuss
tuss-diariashttps://voa.health/fhir/CodeSystem/tuss-diarias-taxas-gases-medicinais
tuss-materiaishttps://voa.health/fhir/CodeSystem/tuss-materiais-opme
tuss-medicamentoshttps://voa.health/fhir/CodeSystem/tuss-medicamentos
sigtaphttps://voa.health/fhir/CodeSystem/sigtap
anvisaurn:voa:anvisa:registro
cbohttps://voa.health/fhir/CodeSystem/cbo
loinchttp://loinc.org
ucumhttp://unitsofmeasure.org
tiss-50https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento
tiss-52https://voa.health/fhir/CodeSystem/tiss-tipo-consulta
tiss-60https://voa.health/fhir/CodeSystem/tiss-unidade-medida
tiss-76https://voa.health/fhir/CodeSystem/tiss-regime-atendimento
voa-categoriahttps://voa.health/fhir/CodeSystem/voa-categoria-servico

A allowlist de licença é definida pelo servidor.

Atribuição

  • CIAP-2 (ICPC-2) © WONCA International Classification Committee. Cite a WONCA ao exibir códigos CIAP-2.
  • This material contains content from LOINC® (http://loinc.org). LOINC is copyright © Regenstrief Institute, Inc. and the LOINC Committee and is available at no cost under the license at http://loinc.org/license.

Erros

ExceçãoSignificado
ChaveInvalidaErrorChave ausente ou inválida
AcessoNegadoErrorA chave não tem acesso ao sistema
CotaExcedidaErrorCota excedida; consulte retry_after
RedeErrorFalha de conexão
TempoEsgotadoErrorTempo limite excedido
ServidorErrorErro retornado pelo serviço

terminologia ou tiss.tuss?

tiss.tuss consulta a tabela TUSS offline embutida no pacote tiss. terminologia é o cliente online da terminologia servida pela Voa, cobre todos os sistemas e valida na versão publicada. Requer chave e está sujeito à cota da organização.

Licença

Apache-2.0. Consulte LICENSE.

Questions fréquentes

Qu'est-ce que terminologia ?

Cliente MCP para consultar terminologias de saúde da Voa.

Comment installer terminologia ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add terminologia -e 'TERMINOLOGIA_KEY=<your terminologia_key>' -e 'TERMINOLOGIA_URL=<TERMINOLOGIA_URL>' -- uvx terminologia==0.1.1 mcp. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour terminologia ?

Oui. Il attend TERMINOLOGIA_KEY, à renseigner dans sa configuration.

terminologia est-il open source ?

Oui. Son code est sur GitHub sous licence Apache-2.0.

Qui maintient terminologia ?

Il est publié par Voa-Health. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.