mcpField
T
terminologia

terminologia

本地服务
docs.voa.health健康医疗0今天更新
代码仓库访问官网

关于 terminologia

terminologia 是用于查询 Voa 提供的医疗术语系统的 Python 客户端和 MCP 服务，涵盖巴西及国际编码集。医疗软件团队可通过在线服务搜索、查询、验证和转换代码。

主要功能

  1. 01搜索术语概念
  2. 02查询并验证代码
  3. 03在系统间转换代码
  4. 04支持 JSON 输出的 CLI
  5. 05本地 MCP 服务模式

适用场景

  1. 01搜索 ICD-10 或 TUSS 概念
  2. 02验证医疗代码
  3. 03将代码转换到其他系统

MCP 相关

Python 包可通过 `terminologia mcp` 启动本地 MCP 服务，向连接的 Agent 提供在线术语服务访问能力。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "health-voa-terminologia": {
      "command": "uvx",
      "args": [
        "terminologia"
      ],
      "env": {
        "TERMINOLOGIA_KEY": "<TERMINOLOGIA_KEY>",
        "TERMINOLOGIA_URL": "<TERMINOLOGIA_URL>"
      }
    }
  }
}
启动命令uvx terminologia
需要配置的环境变量
TERMINOLOGIA_KEY密钥Chave de produto da organização (sk_voa_) com escopo terminology:read.
TERMINOLOGIA_URLURL base FHIR; substitui o endpoint padrão.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
pypiterminologia0.1.1

工具

5

收录的工具列表 · 更新于 1 天前

参数类型必填说明
ninteger否
textostring是
sistemaenum是cid10 | ciap2 | tuss | tuss-diarias | tuss-materiais | tuss-medicamentos | sigtap | sigtap-grupo | sigtap-sub-grupo | sigtap-servico | sigtap-registro | sigtap-financiamento | sigtap-modalidade | anvisa | cbo | cfm-especialidade | rol-ans | dut | cnes | ans-operadora | loinc | ucum | tiss-23 | tiss-25 | tiss-26 | tiss-27 | tiss-28 | tiss-29 | tiss-30 | tiss-31 | tiss-32 | tiss-33 | tiss-34 | tiss-35 | tiss-36 | tiss-37 | tiss-38 | tiss-39 | tiss-40 | tiss-41 | tiss-42 | tiss-43 | tiss-44 | tiss-45 | tiss-46 | tiss-47 | tiss-48 | tiss-49 | tiss-50 | tiss-51 | tiss-52 | tiss-53 | tiss-54 | tiss-55 | tiss-56 | tiss-57 | tiss-58 | tiss-59 | tiss-60 | tiss-61 | tiss-62 | tiss-63 | tiss-65 | tiss-66 | tiss-67 | tiss-68 | tiss-69 | tiss-70 | tiss-71 | tiss-72 | tiss-73 | tiss-74 | tiss-75 | tiss-76 | tiss-77 | tiss-78 | tiss-79 | tiss-80 | tiss-81 | tiss-82 | tiss-87 | voa-categoria

详细介绍

Voa Health

CI PyPI Python 许可证 MCP

文档 · tiss

terminologia

用于查询 FHIR 中 CID-10、CIAP-2、TUSS、TISS、 SIGTAP、CNES、ANVISA、CBO、LOINC、UCUM 及其他术语系统的 Python 客户端和 MCP 工具。

快速开始

pip install terminologia

在 https://tiss-api.voa.health/org 创建组织产品密钥，并进行配置：

export TERMINOLOGIA_KEY=sk_voa_...

现有的 sk_tiss_ 密钥也可以使用，但必须具有 terminology:read 权限范围。

默认端点为 https://terminologia.voa.health/api/v1/fhir。客户端的 base_url 参数优先级更高；未设置该参数时，可设置 TERMINOLOGIA_URL 以使用其他端点。

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)

for estabelecimento in terminologia.sistema("cnes").buscar("hospital das clínicas", n=5):
    print(estabelecimento.code, estabelecimento.display)

CLI

命令用法
terminologia buscar <sistema> <texto> [-n N]搜索概念
terminologia lookup <sistema> <código>查询代码
terminologia validar <sistema> <código>验证代码
terminologia traduzir <sistema> <código> --para SISTEMA转换代码
terminologia sistemas列出系统
terminologia mcp启动本地 MCP 服务

除 mcp 外，在命令中使用 --json 可获取 JSON。成功时退出代码为 0；无结果或代码无效时为 1；使用、密钥、访问、配额、网络或服务错误时为 2。

连接 Agent

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_..."
      }
    }
  }
}

系统

名称标准系统
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
sigtap-grupohttps://voa.health/fhir/CodeSystem/sigtap-grupo
sigtap-sub-grupohttps://voa.health/fhir/CodeSystem/sigtap-sub-grupo
sigtap-servicohttps://voa.health/fhir/CodeSystem/sigtap-servico
sigtap-registrohttps://voa.health/fhir/CodeSystem/sigtap-registro
sigtap-financiamentohttps://voa.health/fhir/CodeSystem/sigtap-financiamento
sigtap-modalidadehttps://voa.health/fhir/CodeSystem/sigtap-modalidade
anvisaurn:voa:anvisa:registro
cbohttps://voa.health/fhir/CodeSystem/cbo
cfm-especialidadehttps://voa.health/fhir/CodeSystem/cfm-especialidade
rol-anshttps://voa.health/fhir/CodeSystem/rol-ans
duthttps://voa.health/fhir/CodeSystem/rol-diretrizes-dut
cnesurn:voa:br:cnes
ans-operadoraurn:voa:br:ans-registro
loinchttp://loinc.org
ucumhttp://unitsofmeasure.org
voa-categoriahttps://voa.health/fhir/CodeSystem/voa-categoria-servico
TISS 领域表（59）

也可通过 terminologia.tiss_dominio(<número>) 访问。

NomeCanônico
tiss-23https://voa.health/fhir/CodeSystem/tiss-carater-atendimento
tiss-25https://voa.health/fhir/CodeSystem/tiss-codigo-despesa
tiss-26https://voa.health/fhir/CodeSystem/tiss-conselho-profissional
tiss-27https://voa.health/fhir/CodeSystem/tiss-debitos-creditos
tiss-28https://voa.health/fhir/CodeSystem/tiss-dentes
tiss-29https://voa.health/fhir/CodeSystem/tiss-diagnostico-imagem
tiss-30https://voa.health/fhir/CodeSystem/tiss-escala-capacidade-funcional
tiss-31https://voa.health/fhir/CodeSystem/tiss-estadiamento-tumor
tiss-32https://voa.health/fhir/CodeSystem/tiss-faces-dente
tiss-33https://voa.health/fhir/CodeSystem/tiss-finalidade-tratamento
tiss-34https://voa.health/fhir/CodeSystem/tiss-forma-pagamento
tiss-35https://voa.health/fhir/CodeSystem/tiss-grau-participacao
tiss-36https://voa.health/fhir/CodeSystem/tiss-indicador-acidente
tiss-37https://voa.health/fhir/CodeSystem/tiss-indicador-debito-credito
tiss-38https://voa.health/fhir/CodeSystem/tiss-mensagens
tiss-39https://voa.health/fhir/CodeSystem/tiss-motivo-encerramento
tiss-40https://voa.health/fhir/CodeSystem/tiss-origem-guia
tiss-41https://voa.health/fhir/CodeSystem/tiss-regime-internacao
tiss-42https://voa.health/fhir/CodeSystem/tiss-regioes-boca
tiss-43https://voa.health/fhir/CodeSystem/tiss-sexo
tiss-44https://voa.health/fhir/CodeSystem/tiss-situacao-inicial-dente
tiss-45https://voa.health/fhir/CodeSystem/tiss-status-solicitacao
tiss-46https://voa.health/fhir/CodeSystem/tiss-status-cancelamento
tiss-47https://voa.health/fhir/CodeSystem/tiss-status-protocolo
tiss-48https://voa.health/fhir/CodeSystem/tiss-tecnica-utilizada
tiss-49https://voa.health/fhir/CodeSystem/tiss-tipo-acomodacao
tiss-50https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento
tiss-51https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento-odontologia
tiss-52https://voa.health/fhir/CodeSystem/tiss-tipo-consulta
tiss-53https://voa.health/fhir/CodeSystem/tiss-tipo-demonstrativo
tiss-54https://voa.health/fhir/CodeSystem/tiss-tipo-guia
tiss-55https://voa.health/fhir/CodeSystem/tiss-tipo-faturamento
tiss-56https://voa.health/fhir/CodeSystem/tiss-natureza-guia
tiss-57https://voa.health/fhir/CodeSystem/tiss-tipo-internacao
tiss-58https://voa.health/fhir/CodeSystem/tiss-tipo-quimioterapia
tiss-59https://voa.health/fhir/CodeSystem/tiss-unidade-federacao
tiss-60https://voa.health/fhir/CodeSystem/tiss-unidade-medida
tiss-61https://voa.health/fhir/CodeSystem/tiss-via-acesso
tiss-62https://voa.health/fhir/CodeSystem/tiss-via-administracao
tiss-63https://voa.health/fhir/CodeSystem/tiss-grupos-procedimentos-ans
tiss-65https://voa.health/fhir/CodeSystem/tiss-metastases
tiss-66https://voa.health/fhir/CodeSystem/tiss-nodulo
tiss-67https://voa.health/fhir/CodeSystem/tiss-tumor
tiss-68https://voa.health/fhir/CodeSystem/tiss-categoria-despesa
tiss-69https://voa.health/fhir/CodeSystem/tiss-versao-componente-comunicacao
tiss-70https://voa.health/fhir/CodeSystem/tiss-forma-envio
tiss-71https://voa.health/fhir/CodeSystem/tiss-tipo-atendimento-operadora-intermediaria
tiss-72https://voa.health/fhir/CodeSystem/tiss-tipo-identificacao-beneficiario
tiss-73https://voa.health/fhir/CodeSystem/tiss-etapas-autorizacao
tiss-74https://voa.health/fhir/CodeSystem/tiss-motivos-ausencia-codigo-validacao
tiss-75https://voa.health/fhir/CodeSystem/tiss-cobertura-especial
tiss-76https://voa.health/fhir/CodeSystem/tiss-regime-atendimento
tiss-77https://voa.health/fhir/CodeSystem/tiss-saude-ocupacional
tiss-78https://voa.health/fhir/CodeSystem/tiss-tipo-pagamento
tiss-79https://voa.health/fhir/CodeSystem/tiss-modelos-remuneracao
tiss-80https://voa.health/fhir/CodeSystem/tiss-formato-documento
tiss-81https://voa.health/fhir/CodeSystem/tiss-tipo-documento
tiss-82https://voa.health/fhir/CodeSystem/tiss-centro-consumo
tiss-87https://voa.health/fhir/CodeSystem/tiss-terminologias-unificadas

许可允许列表由服务器定义。

署名

  • CIAP-2 (ICPC-2) © WONCA International Classification Committee。显示 CIAP-2 代码时，请注明 WONCA。
  • 本材料包含来自 LOINC® (http://loinc.org) 的内容。LOINC 的版权归 © Regenstrief Institute, Inc. 和 LOINC Committee 所有，并可根据 http://loinc.org/license 中的许可免费使用。

错误

异常含义
ChaveInvalidaError缺少密钥或密钥无效
AcessoNegadoError此密钥无权访问该系统
CotaExcedidaError超出配额；请参阅 retry_after
RedeError连接失败
TempoEsgotadoError超时
ServidorError服务返回错误

terminologia 还是 tiss.tuss？

tiss.tuss 查询 tiss 包中内置的离线 TUSS 表。 terminologia 是用于在线查询 Voa 提供的术语的客户端，涵盖所有 系统，并根据已发布的版本进行验证。需要密钥，且受组织配额限制。

许可证

Apache-2.0。请参阅 LICENSE。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。