Skip to main content
Glama
ta-toshio

FileMaker MCP Server

by ta-toshio
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

Install Server
A
security – no known vulnerabilities
F
license - not found
-
quality - not tested

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

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