@obiwan90/edgedb-mcp-server

@obiwan90/edgedb-mcp-server

EdgeDB MCP サーバーは、EdgeDB データベースのクエリおよび管理機能を提供する、Model Context Protocol（MCP）ベースのツールです。コマンドラインツールとして使用することも、ライブラリとして他のプロジェクトに統合することもできます。

機能

• データベース管理ツール

  • データベースに接続（DSN とインスタンス名に対応）
  • 利用可能なデータベースの一覧表示
  • データベースの新規作成
  • 現在のデータベースの切り替え
  • 現在のデータベース情報の取得

• クエリツール

  • EdgeQL クエリの実行
  • パラメーターを指定した EdgeQL クエリの実行
  • 単一レコードの検索
  • 複数レコードの検索（フィルタリング、並べ替え、ページネーションに対応）

• スキーマ管理ツール

  • 型の一覧表示（システム型を含めるかどうかを選択可能）
  • 型の詳細の取得
  • スキーマ構造の比較

インストール

一時的な実行（インストールなし）

npx -y @obiwan90/edgedb-mcp-server@latest

グローバルインストール

npm install -g @obiwan90/edgedb-mcp-server

プロジェクトの依存関係として追加

npm install @obiwan90/edgedb-mcp-server

使用方法

コマンドラインでの使用

# If installed globally
edgedb-mcp-server

# Or via npx for temporary execution
npx -y @obiwan90/edgedb-mcp-server

ライブラリとしての統合

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { registerAllTools } from "@obiwan90/edgedb-mcp-server/build/tools/index.js";
import { registerAllResources } from "@obiwan90/edgedb-mcp-server/build/resources/index.js";

// Initialize MCP server
const server = new McpServer({
    transport: new StdioServerTransport(),
    name: "EdgeDB MCP Server",
    description: "Providing EdgeDB database services through MCP protocol",
    version: "1.0.0"
});

// Register resources and tools
registerAllResources(server);
registerAllTools(server);

// Start the server
(async function() {
    try {
        const transport = new StdioServerTransport();
        await server.connect(transport);
        console.log("MCP server connected, waiting for client requests...");
    } catch (error) {
        console.error("Server startup failed:", error);
        process.exit(1);
    }
})();

環境変数

• EDGEDB_DSN - EdgeDB データベース接続文字列
• EDGEDB_INSTANCE - EdgeDB インスタンス名
• DEBUG - デバッグモードを有効化（true/false）
• LOG_LEVEL - ログレベル（デフォルト：info）

プロジェクト開発

ディレクトリ構成

src/
├── config/           # Configuration management
├── resources/        # MCP resource definitions
├── services/         # Service layer (EdgeDB connection management)
├── tools/            # MCP tool definitions
│   ├── database.ts   # Database management tools
│   ├── query.ts      # Query tools
│   ├── schema.ts     # Schema management tools
│   └── index.ts      # Tool exports
├── types/            # Type definitions
├── utils/            # Utility functions
└── index.ts          # Application entry point

プロジェクトのビルド

# Clone the project
git clone https://github.com/obiwan90/mcp-server-edgedb.git
cd mcp-server-edgedb

# Install dependencies
npm install

# Build the project
npm run build

# Start the service
npm start

Cursor との統合

この MCP サーバーを Cursor エディターと統合するには、次の手順に従ってください。

1. Cursor の MCP 設定ファイル（~/.cursor/mcp.json）を編集します
2. 次の設定を追加します。

"edgedb-server": {
  "command": "npx",
  "args": [
    "-y",
    "@obiwan90/edgedb-mcp-server@latest"
  ]
}

"edgedb-server": {
  "command": "npx",
  "args": [
    "-y",
    "@obiwan90/edgedb-mcp-server@latest",
    "--instanceName",
    "your-instance-name"
  ]
}

3. Cursor エディターを再起動します
4. これで Cursor で EdgeDB ツールを使用できます。コマンドパレット（Cmd+Shift+P）で「EdgeDB」を検索するか、チャットインターフェースからアクセスしてください。

Cursor dialog box input：

mcp_edgedb-server_connectEdgeDB(instanceName="your-instance-name")

ライセンス

このプロジェクトはMIT Licenseの下でライセンスされています。