Fmdapi MCP

FileMaker Data API MCP服务器

一种模型上下文协议（MCP）服务器，通过FileMaker Data API为AI代理提供对FileMaker数据库的直接访问。与Claude Desktop、Claude Code Console、Windsurf、Cursor、Cline和其他启用MCP的AI助手兼容。

](https://www.npmjs.com/package/filemaker-data-api-mcp) 

它做什么

此MCP服务器充当AI代理和FileMaker数据库之间的桥梁，实现与FileMaker数据和数据库结构的自然语言交互：

数据交互

• 查询数据库 -检索、搜索和分析FileMaker记录
• 管理记录 -通过对话创建、更新、删除和复制记录
• 执行脚本 -使用参数运行FileMaker脚本
• 上传文件 -将文件添加到容器字段（包括重复）
• 设置全局字段 -以编程方式管理FileMaker全局字段
• 多数据库支持 -在不同的FileMaker数据库之间动态切换

数据库反思

• 发现结构 -AI代理可以反思数据库模式、布局和字段定义
• 了解关系 -访问门户和相关表信息
• 架构师解决方案 -使AI能够通过自然语言设计和实现FileMaker应用程序
• 元数据访问 -获取有关布局、字段、值列表和脚本的完整信息

这种自省功能允许AI代理了解您的数据库架构，并通过简单的对话帮助您构建、修改和优化FileMaker解决方案。

快速开始

安装

npm install -g filemaker-data-api-mcp

设置

# Add your FileMaker connection
filemaker-mcp config add-connection production \
  --server 192.168.0.24 \
  --database Sales \
  --user admin \
  --password your_password

# Set as default
filemaker-mcp config set-default production

配置您的AI代理

克劳德桌面

编辑配置文件：

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "filemaker": {
      "command": "filemaker-mcp",
      "args": ["start"]
    }
  }
}

风帆/光标/海岸线

添加到MCP设置配置中：

{
  "mcpServers": {
    "filemaker": {
      "command": "filemaker-mcp",
      "args": ["start"]
    }
  }
}

重启你的AI代理，你就准备好了！

特性

连接管理

• ✅ 多个连接 -在不同的FileMaker数据库之间存储和切换
• ✅ 动态切换 -在对话过程中更改数据库
• ✅ 内联凭据 -使用临时凭据连接，无需预先配置
• ✅ 安全存储 -以受限文件权限存储的凭据

数据操作

• ✅ 认证 -登录、注销、会话验证
• ✅ 记录 -创建、读取、更新、删除、复制、查找
• ✅ 元数据 -访问数据库、布局和脚本信息
• ✅ 容器字段 -上传文件（包括重复）
• ✅ 全局字段 -设置全局字段值
• ✅ 脚本 -使用参数执行FileMaker脚本
• ✅ 门户数据 -通过门户访问相关记录

网络传输

• ✅ 标准 -本地使用Claude Desktop（默认）
• ✅ HTTP/HTTPS -远程访问的网络部署

用法示例

示例1：查询数据库

你问：

"Show me all contacts from the production database"

AI代理会自动连接并检索数据。

示例2：数据库反思

你问：

"What is the structure of the Contacts layout? Show me all fields and their types."

AI代理反思数据库模式并提供详细的字段信息。

示例3：在数据库之间切换

你问：

"Compare sales records from production and staging databases"

AI代理在连接之间切换并比较数据。

示例4：创建记录

你问：

"Add a new contact: John Smith, john@example.com, 555-1234"

AI代理使用提供的信息创建记录。

示例5：临时连接

你问：

"Connect to 192.168.0.26, database TestDB, user admin, password test123. Show all records."

AI代理使用内联凭据连接并查询数据库。

示例6：解决方案架构

你问：

"Design a customer management system with contacts, orders, and products. Create the layouts and suggest field definitions."

AI代理使用数据库自检来了解您当前的结构，并帮助构建解决方案。

配置

CLI命令

# Initial setup
filemaker-mcp setup

# Connection management
filemaker-mcp config add-connection  [options]
filemaker-mcp config remove-connection 
filemaker-mcp config list-connections
filemaker-mcp config set-default 
filemaker-mcp config show

# Start server
filemaker-mcp start

# Configure Claude Desktop
filemaker-mcp configure-claude

环境变量

您还可以通过Claude Desktop配置中的环境变量进行配置：

{
  "mcpServers": {
    "filemaker": {
      "command": "filemaker-mcp",
      "args": ["start"],
      "env": {
        "FM_SERVER": "192.168.0.24",
        "FM_DATABASE": "Sales",
        "FM_USER": "admin",
        "FM_PASSWORD": "your_password",
        "FM_VERSION": "vLatest"
      }
    }
  }
}

配置优先

1. 环境变量 （最高）-在MCP配置中定义
2. CLI配置的连接 -存储在 ~/.filemaker-mcp/config.json
3. 内联凭据 （最低）-通过工具参数动态传递

可用工具

MCP服务器提供28个与FileMaker交互的工具：

身份验证（3个工具）

• fm_login -使用FileMaker服务器进行身份验证
• fm_logout -结束会话
• fm_validate_session -检查会话有效性

元数据（5个工具）

• fm_get_product_info -获取FileMaker服务器信息
• fm_get_databases -列出可用数据库
• fm_get_layouts -获取数据库的布局
• fm_get_scripts -获取数据库的脚本
• fm_get_layout_metadata -获取布局字段元数据

记录（7个工具）

• fm_get_records -获取带分页的记录
• fm_get_record_by_id -获取单个记录
• fm_create_record -创建新记录
• fm_edit_record -更新现有记录
• fm_delete_record -删除记录
• fm_duplicate_record -重复记录
• fm_find_records -搜索记录

容器字段（2个工具）

• fm_upload_to_container -将文件上传到容器字段
• fm_upload_to_container_repetition -上传到重复容器字段

全局字段（1个工具）

• fm_set_global_fields -设置全局字段值

脚本（1个工具）

• fm_execute_script -执行FileMaker脚本

配置工具（5个工具）

• fm_config_add_connection -添加预定义连接
• fm_config_remove_connection -断开连接
• fm_config_list_connections -列出所有已配置的连接
• fm_config_get_connection -获取连接详细信息（密码屏蔽）
• fm_config_set_default_connection -设置默认连接

连接工具（4个工具）

• fm_set_connection -切换到预定义连接
• fm_connect -使用内联凭据连接（一次性）
• fm_list_connections -列出可用连接
• fm_get_current_connection -显示当前连接详细信息

先决条件

• Node.js v18或更高版本
• FileMaker 服务器 启用了数据API
• 有效的FileMaker凭据 拥有适当的特权

文档

• 入门指南 -详细的设置说明
• 用户指南 -完整的使用文档
• 令牌生命周期管理 -令牌缓存、刷新和错误恢复
• 部署指导 -生产部署说明
• API 参考 -所有工具均已记录
• 开发指南 -对于贡献者

安全

• 凭据存储在 ~/.filemaker-mcp/config.json 具有受限权限（0o600）
• 列表/显示命令中隐藏的密码
• 切勿共享您的配置文件或将其提交给版本控制
• 为FileMaker服务器帐户使用强密码
• 对于生产，考虑使用环境变量

故障排除

连接问题

# List your connections
filemaker-mcp config list-connections

# Verify connection details
filemaker-mcp config show

克劳德桌面没有响应

1. 验证安装： filemaker-mcp config list-connections
2. 如有需要，进行重建： npm install -g filemaker-data-api-mcp@latest
3. 重新启动克劳德桌面

认证失败

• 验证FileMaker服务器是否正在运行且可访问
• 检查用户名和密码是否正确
• 确保在FileMaker服务器上启用数据API
• 验证用户是否具有适当的权限

发展

地方发展

# Clone repository (update URL after publishing)
git clone https://github.com/yourusername/filemaker-data-api-mcp.git
cd filemaker-data-api-mcp

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Start in development mode
npm run dev

用作图书馆

import { ConnectionManager } from 'filemaker-data-api-mcp';

const manager = new ConnectionManager();
manager.addConnection('mydb', {
  server: '192.168.0.24',
  database: 'Sales',
  user: 'admin',
  password: 'xxx',
  version: 'vLatest'
});

贡献

欢迎投稿！看 开发指南 有关实施细节和 测试指导 用于测试指南。

许可证

MIT许可证-请参阅 许可证 详细信息文件

资源

• FileMaker数据API指南
• 模型上下文协议文档
• Claude桌面文档

支持

• 文档: docs/
• 更新日志: 更改日志.md
• 问题：GitHub问题（发布后更新URL）

______________________________________________________________________

由以下材料制成❤️ 面向FileMaker和AI社区