Nocodb MCP 서버

“Nocodb” MCP 서버는 무엇을 하나요?

Nocodb MCP 서버는 Model Context Protocol(MCP)을 사용하여 AI 어시스턴트와 Nocodb 데이터베이스 간의 다리 역할을 합니다. 이 서버는 AI 기반 클라이언트가 Nocodb 테이블에서 원활한 CRUD(생성, 조회, 수정, 삭제) 작업을 수행할 수 있게 하여 데이터 관리 워크플로우를 촉진합니다. MCP 인터페이스를 통해 데이터베이스 기능을 노출하여, LLM 및 AI 에이전트가 레코드나 컬럼을 조회·생성·수정·삭제하거나, 파일을 업로드해 테이블을 만들 수 있도록 지원합니다. 이 통합은 데이터베이스 상호작용의 자동화와 표준화를 통해 개발자의 생산성을 높여주며, 데이터베이스 중심의 AI 애플리케이션 및 워크플로우를 더 쉽게 구축·테스트·배포할 수 있게 합니다.

프롬프트 목록

• Get Records: 지정된 Nocodb 테이블에서 데이터를 조회합니다.
• Create Record: 지정된 값으로 테이블에 새 행을 추가합니다.
• Update Record: 기존 레코드를 수정(예: 값 변경, 접미사 제거 등)합니다.
• Delete Record: 이름 일치 등 조건에 따라 레코드를 삭제합니다.
• Add Column: 기존 테이블에 새 컬럼을 추가합니다.
• Update Column Values: 모든 행에 대해 컬럼 값을 설정합니다.
• Delete Column: 테이블에서 컬럼을 삭제합니다.
• Create Table from File: JSON 파일의 데이터로 새 테이블을 만듭니다.
• Bulk Create Records: 한번에 여러 새 레코드를 추가합니다.
• Bulk Delete Records: 여러 레코드를 일괄로 삭제합니다.

리소스 목록

• Nocodb 테이블: 연결된 Nocodb 데이터베이스 내 모든 테이블에 접근하여 데이터를 읽고 컨텍스트로 사용할 수 있습니다.
• 테이블 스키마: 컬럼명, 데이터 타입 등 테이블 구조에 대한 메타데이터입니다.
• 업로드 파일: 테이블 생성 또는 업데이트에 사용할 수 있는 JSON 파일(예: example_upload.json)입니다.
• 대량 샘플 데이터: 데모 및 컨텍스트 제공을 위한 docs/sample-bulk 디렉토리 내 예시 대량 데이터와 스크린샷입니다.

도구 목록

• CRUD 작업: 테이블과 레코드에 대한 생성, 조회, 수정, 삭제 기능(프롬프트 템플릿 참조).
• 파일 업로드: 테이블 생성을 위해 JSON 파일을 처리 및 업로드하는 도구.
• 대량 작업: 테이블 내 레코드의 대량 생성 및 삭제 도구.

MCP 서버의 사용 사례

• 데이터베이스 관리: Nocodb 테이블의 CRUD 작업을 자동화하여 개발자의 데이터 입력, 수정, 정리 작업을 간소화합니다.
• 데이터 마이그레이션: JSON 파일 업로드로 Nocodb 데이터베이스에 데이터를 빠르게 마이그레이션하거나 시딩할 수 있습니다.
• 스키마 진화: 컬럼을 프로그래밍 방식으로 추가·제거하여 애플리케이션 데이터 모델 변화를 지원합니다.
• 대량 데이터 작업: 대량 레코드의 생성/삭제를 효율적으로 처리할 수 있어 배치 처리나 자동화 테스트에 유용합니다.
• AI 기반 대시보드: AI 에이전트가 실시간 리포팅, 분석, 대시보드 통합을 위해 데이터를 조회·조작할 수 있습니다.

설치 방법

Windsurf

1. Node.js와 Nocodb 등 필수 요소를 설치하세요.
2. Windsurf 설정 파일(예: settings.json)을 찾으세요.
3. 다음 JSON 스니펫으로 Nocodb MCP 서버를 추가하세요:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. 설정을 저장하고 Windsurf를 재시작하세요.
5. 샘플 데이터베이스 작업으로 서버가 실행 중인지 확인하세요.

Claude

1. Node.js를 설치하고 Nocodb 인스턴스에 접근 가능한지 확인하세요.
2. Claude 플랫폼의 MCP 설정 파일을 수정하세요.
3. 다음과 같이 서버를 추가하세요:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. Claude를 재시작하고 서버 연결을 확인하세요.
5. 테스트 프롬프트로 정상 동작을 확인하세요.

Cursor

1. Node.js와 Nocodb 자격 증명으로 환경을 준비하세요.
2. Cursor의 설정 또는 MCP 통합 패널을 여세요.
3. 아래 설정을 삽입하세요:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. 저장 후 Cursor를 재시작하세요.
5. CRUD 작업을 실행해 서버를 검증하세요.

Cline

1. Node.js를 설치하고 Nocodb 사용 가능 여부를 확인하세요.
2. Cline의 MCP 서버 설정 파일을 수정하세요.
3. 아래와 같이 서버를 추가하세요:

   {
     "mcpServers": {
       "nocodb-mcp": {
         "command": "npx",
         "args": ["@edwinbernadus/nocodb-mcp-server@latest"]
       }
     }
   }
   

4. 변경 내용을 저장하고 Cline을 재시작하세요.
5. Nocodb 테이블에 연결하여 설정을 테스트하세요.

API 키 보안

API 키는 환경 변수로 안전하게 저장하세요. 예시:

{
  "env": {
    "NOCODB_API_KEY": "your-nocodb-key"
  },
  "inputs": {
    "api_key": "${NOCODB_API_KEY}"
  }
}

플로우 내에서 MCP 사용법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 연 후, 시스템 MCP 구성 섹션에 다음 JSON 형식으로 MCP 서버 정보를 입력하세요:

{
  "nocodb-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

구성이 완료되면, AI 에이전트가 이 MCP의 모든 기능과 도구를 사용할 수 있습니다. “nocodb-mcp"를 실제 MCP 서버 이름으로, URL도 본인의 MCP 서버 주소로 변경하는 것을 잊지 마세요.

전체 개요

공식 문서와 구조를 기반으로, Nocodb MCP 서버는 견고한 MCP 통합, 명확한 프롬프트 템플릿, 리소스, 설치 가이드라인을 제공합니다. Roots나 샘플링 지원에 대한 별도의 문서는 없으나, 데이터베이스 워크플로우에 실용적이고 잘 문서화된 MCP 서버입니다.

MCP 점수