Xano MCP 서버

Xano의 메타데이터 API와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 Claude와 같은 AI 어시스턴트가 Cursor 또는 다른 MCP 호환 클라이언트를 통해 사용할 수 있는 도구를 제공합니다.

특징

테이블 관리 : Xano 데이터베이스에서 테이블을 생성, 나열 및 삭제합니다.
스키마 작업 : 포괄적인 스키마 편집 기능을 사용하여 테이블 스키마를 보고 수정합니다.
데이터베이스 관리 : Xano 데이터베이스 구조와 상호 작용하기 위한 완벽한 도구 세트
Swagger Spec : JSON 또는 Markdown(축소 토큰) 형식으로 API 그룹 API 세부 정보 추출

아직 초기 단계이므로 피드백이나 요청을 환영합니다.

Related MCP server: Xano MCP Server for Smithery

필수 조건

Node.js(v16 이상)
npm 또는 다른 Node.js 패키지 관리자
API 액세스가 가능한 Xano 계정
커서, 클로드 데스크탑, 클라인 또는 다른 MCP 클라이언트.

설치

저장소를 복제합니다.

지엑스피1

종속성 설치:

npm install

Xano 자격 증명을 구성하세요.
- index.ts 편집하고 Xano 자격 증명을 설정하세요.
  - XANO_API_KEY : Xano API 키
  - XANO_WORKSPACE : Xano 작업 공간 ID
  - XANO_API_BASE : Xano 인스턴스 API URL(예: https://your-instance.xano.io/api:meta )
프로젝트를 빌드하세요:

npm run build

Claude Desktop과 함께 사용

이 가이드를 따르세요 - https://modelcontextprotocol.io/quickstart/user

다음으로 구성을 업데이트하세요.

{ "mcpServers": { "xano": { "command": "node", "args": [ "/path/to/xano-mcp" ] } } }

/path/to/xano-mcp 프로젝트 디렉토리의 절대 경로로 바꾸세요.

이 기능은 Claude 웹 앱에서는 작동하지 않고 데스크톱 앱에서만 작동합니다 -

커서를 사용한 사용

커서 열기
"MCP 서버 추가"를 클릭하세요
서버를 구성하세요:
- 이름: whatever you want to call it
- 유형: command
- 명령어: node /path/to/xano-mcp/build/index.js

/path/to/xano-mcp 프로젝트 디렉토리의 절대 경로로 바꾸세요.

예시 맥
노드 /Users/your-user/Documents/폴더 이름/xano-mcp/build/index.js

디렉토리 내부에 있다면 터미널에 'pwd' 명령어를 실행하여 절대 경로를 얻을 수 있습니다.

Xano MCP 도구 개요

이 통합은 모델 컨텍스트 프로토콜(MCP)을 통해 Xano 작업 공간을 관리할 수 있는 포괄적인 도구 세트를 제공합니다. 다음과 같은 작업을 수행할 수 있습니다.

데이터베이스 관리

테이블

작업 공간의 모든 테이블 나열
자세한 테이블 스키마 보기
사용자 정의 스키마로 새 테이블 만들기
기존 테이블 삭제
테이블 스키마 수정(열 추가/제거/이름 변경)

스키마 작업

다양한 데이터 유형으로 새 열 추가
열 제거
열 이름 바꾸기
전체 테이블 스키마 업데이트
복잡한 데이터 유형 및 관계 지원

API 관리

API 그룹

새로운 API 그룹 만들기
모든 API 그룹 나열
그룹 내에서 API 찾아보기
Swagger 문서 활성화/비활성화
API 그룹 메타데이터(태그, 브랜치 등)를 관리합니다.

개별 API

그룹에 새로운 API 추가
HTTP 메서드(GET, POST, PUT, DELETE, PATCH, HEAD) 구성
API 문서 설정
메타데이터(태그, 설명) 추가

선적 서류 비치

마크다운(축소된 토큰) 및 JSO(전체) 형식 모두에서 API 그룹 사양을 생성합니다.
Swagger 문서 보기
자세한 스키마 정보에 액세스

이 툴셋을 사용하면 Xano 작업 공간을 완벽하게 관리할 수 있어 MCP 인터페이스를 통해 백엔드 인프라를 프로그래밍 방식으로 구축하고 유지 관리할 수 있습니다.

테이블 삭제 도구 다시 활성화

이 코드베이스에서 삭제 테이블 기능을 다시 활성화하려면 다음 단계별 지침을 따르세요.

코드 편집기에서 src/index.ts 파일을 엽니다.
다음으로 시작하는 주석 처리된 섹션을 찾으세요.
// Delete Table Tool /* server.tool(
그리고 다음으로 끝납니다:
); */
이 섹션의 주석 처리를 해제하려면:
- "Delete Table Tool" 다음 줄의 여는 /* 를 삭제합니다.
- "테이블 스키마 편집 도구" 앞의 닫는 */ 삭제하세요. 이제 테이블 삭제 도구가 다시 활성화됩니다. (새 빌드 실행 후)

코드가 어떻게 보여야 하는지에 대한 예

// Delete Table Tool server.tool( "delete-table", "Delete a table from the Xano workspace", { table_id: z.string().describe("ID of the table to delete") }, async ({ table_id }) => { // ... rest of the implementation } );