FastAPI NCM Attributes Tool

FastAPI NCM 属性工具

此应用提供基于 FastAPI 的 API，用于查询 NCM（南方共同市场通用命名）代码及其相关属性的信息。

功能

• 按代码或描述搜索 NCM 代码
• 获取特定 NCM 代码的所有属性及其可能的取值
• 提供带有完善文档的 RESTful API 端点
• 集成 MCP 服务以支持 AI 交互

数据库结构

此应用使用 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