FastAPI NCM Attributes Tool

FastAPI NCM 属性ツール

このアプリケーションは、NCM（Nomenclatura Comum do Mercosul）コードとそれに関連する属性の情報を取得するための、FastAPI ベースの API を提供します。

機能

• コードまたは説明で NCM コードを検索します
• 特定の NCM コードのすべての属性と、その候補値を取得します
• 適切なドキュメントを備えた RESTful API エンドポイント
• AI との対話のための MCP サーバー連携

データベース構造

このアプリケーションでは、次の主要なテーブルを持つ PostgreSQL データベースを使用します。

• ncm：NCM コードと説明を格納します
• ncm_attributes：NCM コードに関連付けられた属性を格納します
• attribute：属性の定義を格納します

API エンドポイント

NCM 属性

• GET /ncm/{ncm_code}/attributes：特定の NCM コードのすべての属性を取得します
• GET /ncm/search?query={search_term}：コードまたは説明で NCM コードを検索します

MCP ツール

• get_ncm_attributes_tool：NCM コードの属性を取得する MCP ツール

使用例

import requests

# Search for NCM codes
response = requests.get("http://localhost:8000/ncm/search?query=1234")
results = response.json()

# Get attributes for a specific NCM code
response = requests.get("http://localhost:8000/ncm/1234.56.78/attributes")
attributes = response.json()

アーキテクチャ

このアプリケーションは、次の要素で構成されるクリーンアーキテクチャを採用しています。

• モデル：データベーステーブルを表す SQLAlchemy モデル
• リポジトリ：データベース操作を処理します
• サービス：ビジネスロジックを実装します
• スキーマ：リクエスト／レスポンスの検証に使用する Pydantic モデル
• API ルート：HTTP 通信のための FastAPI エンドポイント

アプリケーションの実行

# Run the application
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# Access the API documentation
# Open in browser: http://localhost:8000/docs
``` # fastapi-mcp-server
# fastapi-mcp-server