How do I use FileMaker MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@FileMaker MCP Server show me the fields in the Customers layout" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Jaou Ensatsu Kokuryu FileMaker MCP

FileMaker Data API を通じてデータベース分析・メタデータ抽出を行う MCP（Model Context Protocol）サーバーです。

特徴

読み取り専用: データの安全性を確保（作成・更新・削除は非対応）
メタデータ集約: レイアウト、フィールド、スクリプト情報を一括取得
リレーション推測: フィールド名パターンから関係性を推測（disclaimer付き）
グローバル検索: 複数レイアウトを横断したデータ検索
セキュリティ重視: パスワードのログ出力禁止、ファイルシステム書き込み禁止

クイックスタート

1. ビルド

pnpm install
pnpm run build

2. MCP 設定

本MCPサーバーは、Claude Code、Cursor、Codex など MCP 対応のAIエディタで使用できます。

Claude Code

方法 A: コマンドラインで追加（推奨）

claude mcp add filemaker \
  --transport stdio \
  --scope project \
  --env FM_SERVER=https://your-server.com \
  --env FM_DATABASE=your-database \
  --env FM_USERNAME=your-username \
  --env FM_PASSWORD=your-password \
  -- node /path/to/jaou-ensatsu-kokuryu-filemaker-mcp/dist/index.js

スコープオプション	説明
`--scope user`	全プロジェクト共通（`~/.claude.json` に保存）
`--scope project`	現在のプロジェクトのみ（`.mcp.json` に保存、Git管理可能）

方法 B: 設定ファイルを直接編集

~/.claude.json に以下を追加:

{
  "mcpServers": {
    "filemaker": {
      "command": "node",
      "args": ["/path/to/jaou-ensatsu-kokuryu-filemaker-mcp/dist/index.js"],
      "env": {
        "FM_SERVER": "https://your-server.com",
        "FM_DATABASE": "your-database",
        "FM_USERNAME": "your-username",
        "FM_PASSWORD": "your-password"
      }
    }
  }
}

Note: Claude Desktop を使用する場合は ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）に同様の設定を追加してください。

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に以下を追加:

{
  "mcpServers": {
    "filemaker": {
      "command": "node",
      "args": ["/path/to/jaou-ensatsu-kokuryu-filemaker-mcp/dist/index.js"],
      "env": {
        "FM_SERVER": "https://your-server.com",
        "FM_DATABASE": "your-database",
        "FM_USERNAME": "your-username",
        "FM_PASSWORD": "your-password"
      }
    }
  }
}

設定後、Cursor の設定画面（File → Preferences → Cursor Settings → MCP）で「Available Tools」に表示されることを確認してください。

Codex (OpenAI)

方法 A: コマンドラインで追加

codex mcp add filemaker \
  --env FM_SERVER=https://your-server.com \
  --env FM_DATABASE=your-database \
  --env FM_USERNAME=your-username \
  --env FM_PASSWORD=your-password \
  -- node /path/to/jaou-ensatsu-kokuryu-filemaker-mcp/dist/index.js

方法 B: 設定ファイルを直接編集

~/.codex/config.toml に以下を追加:

[mcp_servers.filemaker]
command = "node"
args = ["/path/to/jaou-ensatsu-kokuryu-filemaker-mcp/dist/index.js"]

[mcp_servers.filemaker.env]
FM_SERVER = "https://your-server.com"
FM_DATABASE = "your-database"
FM_USERNAME = "your-username"
FM_PASSWORD = "your-password"

Note: Codex は CLI と VSCode 拡張機能で設定ファイルを共有しています。

3. 使用例

MCP設定後、AIエディタを起動すると FileMaker MCP ツールが利用可能になります。

# 使用例（AI への指示）
「FileMaker にログインして、顧客レイアウトのフィールド一覧を取得してください」
「売上データベースのメタデータをエクスポートしてください」
「注文テーブルで"東京"を含むレコードを検索してください」

提供ツール（16ツール）

認証系

ツール	説明
`fm_login`	FileMaker サーバーへのログイン
`fm_logout`	セッション終了
`fm_validate_session`	セッション有効性確認

メタデータ取得系

ツール	説明
`fm_get_layouts`	レイアウト一覧取得
`fm_get_layout_metadata`	フィールド定義取得
`fm_get_scripts`	スクリプト一覧取得
`fm_list_value_lists`	値一覧取得

レコード操作系（読み取りのみ）

ツール	説明
`fm_get_records`	レコード取得（ページング対応）
`fm_get_record_by_id`	ID指定でレコード取得
`fm_find_records`	検索クエリでレコード取得
`fm_get_record_count`	レコード件数取得

分析系

ツール	説明
`fm_export_database_metadata`	メタデータ一括エクスポート
`fm_infer_relationships`	リレーション推測
`fm_analyze_portal_data`	ポータル構造分析
`fm_global_search_data`	複数レイアウト横断検索
`fm_global_search_fields`	フィールド名検索

主要ツールの使用例

環境変数が設定されている場合、引数なしでログイン可能:

// 入力（環境変数使用）
{}

// 入力（引数指定）
{
  "server": "https://your-server.com",
  "database": "YourDB",
  "username": "admin",
  "password": "password123"
}

// 出力
{
  "success": true,
  "message": "Login successful"
}

fm_get_layout_metadata - レイアウトメタデータ取得

// 入力
{
  "layout": "顧客マスタ"
}

// 出力
{
  "success": true,
  "layout": "顧客マスタ",
  "fields": [
    {
      "name": "顧客ID",
      "type": "normal",
      "result": "number",
      "autoEnter": true
    },
    {
      "name": "顧客名",
      "type": "normal",
      "result": "text"
    }
  ],
  "portalNames": ["注文履歴", "連絡先"]
}

fm_find_records - レコード検索

// 入力
{
  "layout": "注文",
  "query": [
    { "顧客名": "田中*" },
    { "都道府県": "東京都" }
  ],
  "sort": [
    { "fieldName": "注文日", "sortOrder": "descend" }
  ],
  "limit": 50
}

// 出力
{
  "success": true,
  "records": [...],
  "dataInfo": {
    "foundCount": 25,
    "returnedCount": 25,
    "totalRecordCount": 1500
  }
}

fm_export_database_metadata - メタデータエクスポート

// 入力
{
  "includeFields": true,
  "includeScripts": true
}

// 出力
{
  "success": true,
  "database": "SalesDB",
  "exportedAt": "2026-01-03T12:00:00Z",
  "layouts": [...],
  "scripts": [...]
}

環境変数

変数名	必須	デフォルト	説明
`FM_SERVER`	Yes	-	FileMaker サーバー URL（HTTPS必須）
`FM_DATABASE`	Yes	-	データベース名
`FM_USERNAME`	Yes	-	ユーザー名
`FM_PASSWORD`	Yes	-	パスワード
`FM_API_VERSION`	No	`vLatest`	Data API バージョン
`FM_SSL_VERIFY`	No	`true`	SSL 証明書検証（開発環境でのみ`false`可）
`FM_SESSION_TIMEOUT`	No	`840`	セッションタイムアウト（秒）
`LOG_LEVEL`	No	`warn`	ログレベル（debug, info, warn, error）

開発

環境構築

pnpm install
cp .env.example .env  # テスト実行用

コマンド

pnpm run build       # ビルド
pnpm test            # テスト実行
pnpm run typecheck   # 型チェック
pnpm run lint        # リント
pnpm run lint:fix    # リント自動修正

制限事項

FileMaker Data API の制約により、テーブル一覧やリレーション定義の直接取得は不可
レイアウトに配置されたフィールドのみ操作可能
fm_infer_relationships の結果は推測であり、実際のリレーション定義と異なる場合あり
読み取り専用（レコードの作成・更新・削除は非対応）

参考プロジェクト

本プロジェクトは以下のオープンソースプロジェクトを参考に設計・実装しました：

プロジェクト	作者	説明
FileMaker-Server-DAPI-MCP	Francesc Sans	FileMaker Data API MCP サーバー（接続管理機能）
filemaker-mcp-server	Max Petrusenko	DDRエクスポート・リレーション分析機能を持つ MCP サーバー

両プロジェクトともMITライセンスで公開されています。

ライセンス

MIT

FileMaker MCP Server

Jaou Ensatsu Kokuryu FileMaker MCP

特徴

クイックスタート

1. ビルド

2. MCP 設定

Claude Code

Cursor

Codex (OpenAI)

3. 使用例

提供ツール（16ツール）

認証系

メタデータ取得系

レコード操作系（読み取りのみ）

分析系

主要ツールの使用例

fm_get_layout_metadata - レイアウトメタデータ取得

fm_find_records - レコード検索

fm_export_database_metadata - メタデータエクスポート

環境変数

開発

環境構築

コマンド

制限事項

参考プロジェクト

ライセンス

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

Jaou Ensatsu Kokuryu FileMaker MCP

特徴

クイックスタート

1. ビルド

2. MCP 設定

Claude Code

Cursor

Codex (OpenAI)

3. 使用例

提供ツール（16ツール）

認証系

メタデータ取得系

レコード操作系（読み取りのみ）

分析系

主要ツールの使用例

fm_login - ログイン

fm_get_layout_metadata - レイアウトメタデータ取得

fm_find_records - レコード検索

fm_export_database_metadata - メタデータエクスポート

環境変数

開発

環境構築

コマンド

制限事項

参考プロジェクト

ライセンス

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API