Skip to main content
Glama

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

-
security - not tested
F
license - not found
-
quality - not tested

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ta-toshio/filemaker-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server