RIB iTWO 4.0 MCP Server

RIB iTWO 4.0 인스턴스의 SQL Server 데이터베이스에 접근하기 위한 읽기 전용 MCP 서버입니다.

도구

• list_schemas – 모든 스키마 나열

• list_tables(schema) – 스키마의 테이블/뷰

• search_tables(keyword) – 모든 스키마에서 이름으로 테이블 검색

• describe_table(schema, table) – 열, 유형, Null 허용 여부

• run_query(sql) – 임의의 SELECT 문 (읽기 전용 강제)

Related MCP server: mcp-sqlserver-readonly

설정

1. ODBC 드라이버 설치: Windows용 Microsoft ODBC Driver 18 for SQL Server를 설치합니다.

2. DB 사용자 생성: SQL Server에서 iTWO 데이터베이스에 대해 db_datareader 역할(읽기 전용)을 가진 로그인을 생성합니다. 서버 측 권한이 실제 보안 장치이며, 서버의 쿼리 필터링은 추가 보호 계층일 뿐입니다.

3. 의존성 설치:

   cd "C:\Users\schol\Desktop\MCP Datenbank"
   python -m venv .venv
   .venv\Scripts\Activate.ps1
   pip install -e .

4. 구성: .env.example을 .env로 복사하고 접속 정보를 입력합니다.

   Copy-Item .env.example .env

5. 로컬 테스트:

   python -m rib_itwo_mcp.server

Coolify에 배포

서버는 HTTP 서비스(전송 streamable-http)로 실행되므로 Claude가 원격으로 연결할 수 있습니다. ODBC 드라이버는 Dockerfile에 포함되어 있으므로 Coolify 호스트 자체에 DB 클라이언트를 설치할 필요가 없습니다.

1. 저장소를 Git에 푸시합니다(GitHub/GitLab 등).

2. Coolify에서 이 저장소로 새 Application을 만들고 Build-Pack: Dockerfile을 선택합니다.

3. Coolify에서 환경 변수를 설정합니다(.env.example 기반):

   • DB_SERVER, DB_NAME, DB_USER, DB_PASSWORD

   • DB_DRIVER=ODBC Driver 18 for SQL Server

   • DB_TRUST_SERVER_CERTIFICATE=yes (또는 유효한 인증서가 있는 경우 no)

   • DB_ALLOWED_SCHEMAS, DB_MAX_ROWS 선택 사항

   • MCP_AUTH_TOKEN — 필수, 길고 무작위한 시크릿(openssl rand -hex 32)입니다. 그렇지 않으면 엔드포인트가 네트워크에 공개적으로 접근 가능하게 됩니다.

4. 포트 8000을 열거나 Coolify 프록시/도메인을 해당 포트에 매핑합니다. 헬스체크 경로는 /health입니다.

5. 배포합니다. SQL Server는 Coolify 호스트에서 네트워크로 접근 가능해야 합니다(필요 시 방화벽/보안 그룹을 조정하고 포트 1433을 엽니다).

Claude에 커넥터로 추가(원격/HTTP)

앱이 예를 들어 https://rib-itwo-mcp.deine-domain.de에서 접근 가능해지면:

claude mcp add --transport http rib-itwo https://rib-itwo-mcp.deine-domain.de/mcp --header "Authorization: Bearer <dein-MCP_AUTH_TOKEN>"

(Claude Desktop/웹 인터페이스에서 "Custom Connector"로 URL + Bearer 토큰을 입력합니다.)

로컬에서 stdio 커넥터로 사용(Coolify 없이 대안)

HTTP 없이 순수 로컬 사용을 위해 MCP_TRANSPORT=stdio를 설정할 수 있습니다:

claude mcp add rib-itwo -e MCP_TRANSPORT=stdio -- "C:\Users\schol\Desktop\MCP Datenbank\.venv\Scripts\python.exe" -m rib_itwo_mcp.server

보안

• run_query는 단일 SELECT/WITH 문만 허용하며, 여러 문과 쓰기/관리 키워드를 차단합니다.

• 또한 DB 사용자 자신도 읽기 권한만 보유해야 합니다(db_datareader). 그래야 보안이 쿼리 필터링에만 의존하지 않습니다.

• 선택적으로 DB_ALLOWED_SCHEMAS를 사용하여 특정 스키마로 액세스를 제한할 수 있습니다.

• DB_MAX_ROWS는 쿼리당 결과 수를 제한합니다.

• HTTP 배포(Coolify)의 경우 MCP_AUTH_TOKEN은 엔드포인트 앞의 유일한 접근 차단입니다. 토큰이 설정되지 않으면 서버는 네트워크 접근이 가능한 모든 사람에게 열려 있습니다. 또한 Coolify 프록시/도메인을 통해 TLS를 사용하여 토큰이 평문으로 전송되지 않도록 해야 합니다.