TDengine 쿼리 MCP 서버
AI 비서를 위한 읽기 전용 TDengine 데이터베이스 쿼리를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. AI 기반 도구에서 직접 쿼리를 실행하고, 데이터베이스 구조를 탐색하고, 데이터를 분석할 수 있습니다.
지원되는 AI 도구
이 MCP 서버는 다음을 포함하여 모델 컨텍스트 프로토콜을 지원하는 모든 도구와 함께 작동합니다.
커서 IDE :
.cursor/mcp.json에 설정Anthropic Claude : 호환되는 MCP 클라이언트와 함께 사용
기타 MCP 호환 AI 어시스턴트 : 도구의 MCP 구성 지침을 따르세요.
Related MCP server: MCP MySQL App
기능 및 제한 사항
그것이 하는 일
✅ 읽기 전용 TDengine 쿼리(SELECT, SHOW, DESCRIBE만 해당)를 실행합니다.
✅ 데이터베이스/안정적인 정보 및 메타데이터 제공
✅ 사용 가능한 데이터베이스 및 마구간 목록
그것이 하지 않는 것
❌ 쓰기 작업(INSERT, UPDATE, DELETE, CREATE, ALTER 등)을 실행합니다.
❌ 데이터베이스 설계 또는 스키마 생성 기능 제공
❌ 전체 데이터베이스 관리 도구로서의 기능
이 도구는 읽기 전용 쿼리를 통한 데이터 조사 및 탐색을 위해 특별히 설계되었습니다. 데이터베이스 관리, 스키마 관리 또는 데이터 수정에는 사용할 수 없습니다.
사용 방법
소스 코드에서 실행
이 MCP 서버를 사용하는 권장 방법은 설치 없이 uv 사용하여 직접 실행하는 것입니다. 아래 예시에서는 Claude Desktop과 Cursor가 이 방식으로 구성되어 있습니다.
저장소를 복제하려면 다음을 수행하세요.
지엑스피1
그러면 서버를 직접 실행할 수 있습니다.
또는 src/tdengine_mcp_server/ 디렉토리에 있는 .env 파일을 변경하여 환경 변수를 설정하고 다음 명령으로 서버를 실행할 수 있습니다.
중요: .env 파일은 명령줄 인수보다 우선순위가 높습니다 .
pip 명령어로 Pypi에서 설치
그런 다음 다음을 실행합니다.
uvx 명령어로 설치
npx 명령어로 smithery에서 설치
--client 옵션 뒤에 claude , 'windsurf' 등의 다른 옵션을 추가하여 클라이언트를 변경할 수 있습니다. smithery/tdengine-mcp-server 파일도 참조할 수 있습니다.
구성 옵션
.env 파일
환경 변수 | 설명 | 기본 |
로그 레벨 | 로그 수준(DEBUG, INFO, WARN, ERROR)을 설정합니다. | 정보 |
TDENGINE_HOST | 환경을 위한 데이터베이스 호스트 | 로컬호스트 |
TD엔진_포트 | 데이터베이스 포트 | 6041 |
TDENGINE_USERNAME | 데이터베이스 사용자 이름 | 뿌리 |
TDENGINE_PASSWORD | 데이터베이스 비밀번호 | 타오스데이터 |
TDENGINE_DATABASE | 데이터베이스 이름 | 통나무 |
TDENGINE_TIMEOUT | 연결 시간 초과를 초 단위로 설정하세요 | 30 |
수송 | 사용할 운송 수단을 제어합니다 | stdio |
CLI 사용법
AI 어시스턴트와의 통합
AI 비서는 MCP 서버를 통해 TDengine 데이터베이스와 상호 작용할 수 있습니다. 다음은 몇 가지 예입니다.
예시 쿼리:
TDengine MCP 도구 사용
TDengine Query MCP 서버는 AI 어시스턴트가 사용할 수 있는 세 가지 주요 도구를 제공합니다.
1. 질의
특정 안정된 것에 대해 읽기 전용 SQL 쿼리를 실행합니다.
2. 정보
귀하의 마구간에 대한 자세한 정보를 얻으세요:
보안 고려 사항
✅ 읽기 전용 쿼리만 허용됩니다(SELECT, SHOW, DESCRIBE)
문제 해결
연결 문제
연결에 문제가 있는 경우:
MCP 구성에서 데이터베이스 자격 증명을 확인하세요.
TDengine 서버가 실행 중이고 접근 가능한지 확인하세요.
연결을 차단하는 방화벽 규칙을 확인하세요
구성에서
LOG_LEVEL설정하여 디버그 모드를 활성화하세요.
일반적인 오류
오류: 쿼리 실행에 실패했습니다.
SQL 구문을 확인하세요
지원되는 쿼리 유형(SELECT, SHOW, DESCRIBE)만 사용하고 있는지 확인하세요.
귀하의 쿼리가 실제로 읽기 전용인지 확인하세요.
기여하다
기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.
자세한 정보나 지원이 필요하면 GitHub 저장소에서 이슈를 열어 주세요.