Xano MCP Server H9l

🚀 Xano MCP サーバー

このサーバーは、Xano API との接続を行うモデルコンテキストプロトコル (MCP) サーバーの実装です。MCP インターフェースを通じて Xano データベース操作を管理するためのツールとリソースを提供します。

✨ 主な機能

• Xano API の安全な認証を使用
• TypeScript ベースの型安全な API インタラクション
• 環境変数による設定
• MCP 標準に準拠したインターフェース
• ワークスペース管理ツール
• テーブル内容の操作（作成、読み取り、更新）
• 詳細なメッセージを伴う改善されたエラー処理

📦 インストール

# リポジトリをクローン
git clone [your-repo-url]
cd xano_mcp

# 依存関係をインストール
npm install

📚 ドキュメント

設定

1. サンプル環境ファイルをコピーします。

   cp .env.example .env
   

2. .env ファイルを Xano の資格情報で更新します。

   XANO_API_KEY=your_api_key_here
   XANO_API_URL=your_xano_api_url
   NODE_ENV=development
   API_TIMEOUT=10000
   

開発

# プロジェクトをビルド
npm run build

# 開発モードで実行
npm run dev

# サーバーを起動
npm start

プロジェクト構造

xano_mcp/
├── src/
│   ├── api/
│   │   └── xano/
│   │       ├── client/       # API クライアントの実装
│   │       ├── models/       # データモデルと型
│   │       ├── services/     # API サービスの実装
│   │       └── utils/        # ユーティリティ関数
│   ├── mcp/
│   │   ├── server/          # MCP サーバーの実装
│   │   ├── tools/           # MCP ツールの実装
│   │   └── types/           # ツール固有の型
│   ├── config.ts            # 設定管理
│   └── index.ts             # エントリーファイル
├── .env                     # 環境変数ファイル
├── .env.example            # サンプル環境変数
└── package.json            # プロジェクトの依存関係とスクリプト

利用可能なツール

基本的な使用法

• ワークスペースの作成：createWorkSpace を使用して新しいワークスペースを作成します。

  const result = await createWorkSpace({
    name: "test", // ワークスペース名
    description: "テスト用ワークスペース" // ワークスペースの説明
  });
  

• テーブルの作成：createTable を使用して指定されたワークスペースに新しいテーブルを作成します。

  const result = await createTable(wspId, {
    name: "users", // テーブル名
    columns: ["id", "name", "email"] // テーブルの列
  });
  

• データの挿入：insertData を使用して指定されたテーブルにデータを追加します。

  const result = await insertData(wspId, tableId, {
    data: [
      { id: 1, name: "Alice", email: "alice@example.com" },
      { id: 2, name: "Bob", email: "bob@example.com" }
    ]
  });
  

環境変数

エラー処理

サーバーは以下の詳細なエラーメッセージを提供します。

• 無効なパラメータ
• 認証失敗
• API リクエスト失敗
• 内容検証エラー
• 未知のツールリクエスト

セキュリティ

• 環境変数を使用して機密設定を保存
• TruffleHog を統合してシークレットの漏洩を防止
• API キーや機密データはコードリポジトリには決してコミットされません

コントリビューションガイド

1. 機能ブランチを作成します。
2. 変更を加えます。
3. プルリクエストを送信します。

📄 ライセンス

ISC