Xano MCP 서버
Xano API와 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버 구현입니다. 이 서버는 MCP 인터페이스를 통해 Xano 데이터베이스 작업을 관리하기 위한 도구와 리소스를 제공합니다.
특징
Xano API를 통한 보안 인증
TypeScript를 사용한 유형 안전 API 상호 작용
환경 기반 구성
MCP 호환 인터페이스
작업 공간 관리 도구
테이블 콘텐츠 작업(생성, 읽기, 업데이트)
자세한 메시지로 오류 처리가 개선되었습니다.
Related MCP server: Xano MCP Server
설치
지엑스피1
구성
예제 환경 파일을 복사하세요.
cp .env.example .envXano 자격 증명으로
.env파일을 업데이트하세요.
XANO_API_KEY=your_api_key_here
XANO_API_URL=your_xano_api_url
NODE_ENV=development
API_TIMEOUT=10000개발
# Build the project
npm run build
# Run in development mode
npm run dev
# Start the server
npm start프로젝트 구조
xano_mcp/
├── src/
│ ├── api/
│ │ └── xano/
│ │ ├── client/ # API client implementation
│ │ ├── models/ # Data models and types
│ │ ├── services/ # API service implementations
│ │ └── utils/ # Utility functions
│ ├── mcp/
│ │ ├── server/ # MCP server implementation
│ │ ├── tools/ # MCP tool implementations
│ │ └── types/ # Tool-specific types
│ ├── config.ts # Configuration management
│ └── index.ts # Main entry point
├── .env # Environment variables (not in git)
├── .env.example # Example environment variables
└── tsconfig.json # TypeScript configuration사용 가능한 MCP 도구
작업 공간 도구
get_workspaces: 사용 가능한 모든 작업 공간 나열
테이블 도구
create_table: 작업 공간에 새 테이블을 만듭니다.get_table_content: 페이지네이션을 지원하는 테이블에서 콘텐츠 가져오기add_table_content: 테이블에 새 콘텐츠를 추가합니다.update_table_content: 테이블의 기존 콘텐츠를 업데이트합니다.get_all_tables: 자세한 정보와 함께 작업 공간의 모든 테이블을 나열합니다.
사용 예
작업 공간 작업
// List available workspaces
const result = await mcp.use_tool("get_workspaces", {});
console.log('Workspaces:', result);테이블 관리
// Create a new table
const createResult = await mcp.use_tool("create_table", {
workspaceId: 123,
name: "MyTable"
});
// Add content to a table
const addResult = await mcp.use_tool("add_table_content", {
workspaceId: 123,
tableId: 456,
content: {
created_at: "2024-01-22T17:07:00.000Z"
}
});
// Get table content with pagination
const getResult = await mcp.use_tool("get_table_content", {
workspaceId: 123,
tableId: 456,
pagination: {
page: 1,
items: 50
}
});
// Update table content
const updateResult = await mcp.use_tool("update_table_content", {
workspaceId: 123,
tableId: 456,
contentId: "789",
content: {
created_at: "2024-01-22T17:07:00.000Z"
}
});
// List all tables in a workspace
const tables = await mcp.use_tool("get_all_tables", {
workspaceId: 123
});
console.log('Tables:', tables);
// Returns an array of tables with their details:
// [
// {
// id: number,
// name: string,
// description: string,
// created_at: string,
// updated_at: string,
// guid: string,
// auth: boolean,
// tag: string[],
// workspaceId: number
// },
// ...
// ]환경 변수
변하기 쉬운 | 설명 | 필수의 | 기본 |
XANO_API_KEY | Xano API 인증 키 | 예 | - |
XANO_API_URL | Xano API 엔드포인트 URL | 예 | - |
노드_환경 | 환경(개발/생산) | 아니요 | 개발 |
API 타임아웃 | API 요청 시간 초과(밀리초) | 아니요 | 10000 |
오류 처리
서버는 다음에 대한 자세한 오류 메시지를 제공합니다.
잘못된 매개변수
인증 실패
API 요청 실패
콘텐츠 검증 오류
알 수 없는 도구 요청
보안
환경 변수는 민감한 구성에 사용됩니다.
비밀 유출을 방지하기 위해 TruffleHog 구성이 포함되어 있습니다.
API 키와 민감한 데이터는 저장소에 커밋되지 않습니다.
기여하다
기능 브랜치 생성
변경 사항을 만드세요
풀 리퀘스트 제출
특허
아이에스씨