Jaou Ensatsu Kokuryu FileMaker MCP

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

特徴

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

クイックスタート

1. ビルド

pnpm install
pnpm run build

2. Claude Code での MCP 設定

方法 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）に同様の設定を追加してください。

3. Claude Code での使用

Claude Code を起動すると、FileMaker MCP ツールが利用可能になります。

# 使用例（Claude への指示）
「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	フィールド名検索

---

主要ツールの使用例

fm_login - ログイン

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

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

// 入力（引数指定）
{
  "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