terminologia

Name: terminologia
Author: voa.health

ローカル

docs.voa.healthヘルスケア0今日更新

リポジトリ公式サイト

terminologia について

terminologiaは、Voaが提供する医療用語システムを検索するPythonクライアント兼MCPサーバーです。ブラジルおよび国際的なコード体系を対象に、医療ソフトウェアチームがオンラインサービスでコードを検索、照会、検証、変換できます。

主な機能

01用語概念の検索
02コードの照会と検証
03体系間のコード変換
04JSON出力対応CLI
05ローカルMCPサーバーモード

活用シーン

01ICD-10やTUSSの概念を検索
02医療コードを検証
03コードを別の体系に変換

MCP 対応

Pythonパッケージから `terminologia mcp` を実行してローカルMCPサーバーを起動できます。接続したエージェントにオンライン用語サービスへのアクセスを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの 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.1stdio

ツール

掲載時のツール一覧 · 1 日前に更新

パラメーター	型	必須	説明
n	integer	いいえ
texto	string	はい
sistema	enum	はい	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

詳細

ドキュメント · 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 です。

エージェントを接続する

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

システム

名前	正規 URI
`cid10`	`http://hl7.org/fhir/sid/icd-10`
`ciap2`	`http://hl7.org/fhir/sid/icpc-2`
`tuss`	`https://voa.health/fhir/CodeSystem/tuss`
`tuss-diarias`	`https://voa.health/fhir/CodeSystem/tuss-diarias-taxas-gases-medicinais`
`tuss-materiais`	`https://voa.health/fhir/CodeSystem/tuss-materiais-opme`
`tuss-medicamentos`	`https://voa.health/fhir/CodeSystem/tuss-medicamentos`
`sigtap`	`https://voa.health/fhir/CodeSystem/sigtap`
`sigtap-grupo`	`https://voa.health/fhir/CodeSystem/sigtap-grupo`
`sigtap-sub-grupo`	`https://voa.health/fhir/CodeSystem/sigtap-sub-grupo`
`sigtap-servico`	`https://voa.health/fhir/CodeSystem/sigtap-servico`
`sigtap-registro`	`https://voa.health/fhir/CodeSystem/sigtap-registro`
`sigtap-financiamento`	`https://voa.health/fhir/CodeSystem/sigtap-financiamento`
`sigtap-modalidade`	`https://voa.health/fhir/CodeSystem/sigtap-modalidade`
`anvisa`	`urn:voa:anvisa:registro`
`cbo`	`https://voa.health/fhir/CodeSystem/cbo`
`cfm-especialidade`	`https://voa.health/fhir/CodeSystem/cfm-especialidade`
`rol-ans`	`https://voa.health/fhir/CodeSystem/rol-ans`
`dut`	`https://voa.health/fhir/CodeSystem/rol-diretrizes-dut`
`cnes`	`urn:voa:br:cnes`
`ans-operadora`	`urn:voa:br:ans-registro`
`loinc`	`http://loinc.org`
`ucum`	`http://unitsofmeasure.org`
`voa-categoria`	`https://voa.health/fhir/CodeSystem/voa-categoria-servico`

TISS ドメインテーブル（59）

terminologia.tiss_dominio(<número>) からもアクセスできます。

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

ライセンスの許可リストはサーバーによって定義されます。

帰属表示

この資料には、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 対応

ログインしてコメント

基本情報

作者: voa.health
言語: python
バージョン: 0.1.1
トランスポート: stdio
掲載日: 2026年10月26日
最終更新: 今日
公式 Registry: health.voa/terminologia

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

terminologia

terminologia について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

terminologia

クイックスタート

CLI

エージェントを接続する

システム

帰属表示

エラー

terminologia と tiss.tuss のどちらを使うべきですか？

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？