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 | フィールド名検索 |
主要ツールの使用例
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