TiDB MCP 서버

MCP 도구를 통해 SELECT 쿼리를 실행할 수 있는 TiDB용 MCP(Model Context Protocol) 서버입니다.

특징

TiDB에서 SELECT 쿼리 실행
환경 변수를 통한 보안 연결
가볍고 사용하기 쉬움

필수 조건

노드.js 16+
TiDB 인스턴스

설치

npx를 통해

지엑스피1

글로벌 설치

npm install -g tidb-mcp-server
tidb-mcp-server

구성

실행하기 전에 다음 환경 변수를 설정하세요.

export TIDB_HOST="your_tidb_host"
export TIDB_PORT="your_tidb_port" 
export TIDB_USER="your_username"
export TIDB_PASS="your_password"
export TIDB_DB="your_database"

# Optional operation permissions (default: false)
export ALLOW_INSERT_OPERATION="false"  # Set to "true" to allow INSERT operations
export ALLOW_UPDATE_OPERATION="false"  # Set to "true" to allow UPDATE operations 
export ALLOW_DELETE_OPERATION="false"  # Set to "true" to allow DELETE operations

WARNING: Enabling these operations may expose your database to modification risks.
Only enable what you need and ensure proper access controls are in place.

용법

서버를 시작합니다:

tidb-server

MCP 구성에 추가(cline_mcp_settings.json):

{
  "mcpServers": {
    "tidb-server": {
      "command": "npx",
      "args": ["-y", "tidb-mcp-server"], # Also adding the -y flag for consistency
      "env": {
        "TIDB_HOST": "your_tidb_host",
        "TIDB_PORT": "your_tidb_port",
        "TIDB_USER": "your_username",
        "TIDB_PASS": "your_password",
        "TIDB_DB": "your_database"
      }
    }
  }
}

MCP 도구를 사용하세요:

const result = await use_mcp_tool({
  server_name: 'tidb-server',
  tool_name: 'tidb_query', 
  arguments: {
    sql: 'SELECT * FROM your_table LIMIT 10'
  }
});

개발

저장소를 복제합니다.

git clone https://github.com/l1806858547/tidb-server.git
cd tidb-server

종속성 설치:

npm install

짓다:

npm run build

달리다:

node build/index.js

특허

MIT