English Français العربية

terminologia

السجل الرسمي أخرى

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • TERMINOLOGIA_KEY إلزامي سري Chave de produto da organização (sk_voa_) com escopo terminology:read.
  • TERMINOLOGIA_URL URL base FHIR; substitui o endpoint padrão.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو terminologia؟

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

كيف أثبّت terminologia؟

يعمل على جهازك. في Claude Code: claude mcp add terminologia -e 'TERMINOLOGIA_KEY=<your terminologia_key>' -e 'TERMINOLOGIA_URL=<TERMINOLOGIA_URL>' -- uvx terminologia==0.1.1 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج terminologia إلى مفتاح API؟

نعم. يتطلب TERMINOLOGIA_KEY، وتضبطها في إعداداته.

هل terminologia مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون terminologia؟

ينشره Voa-Health. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.