FileMaker数据库连接工具

filemaker-mcp是一个MCP服务器,通过OData v4协议为AI助手提供实时访问FileMaker数据库的功能,支持只读查询、模式发现和基于pandas的分析。

  • by nietsneuah
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 nietsneuah/filemaker-mcp

使用说明

文件生成器mcp

将Claude(或任何MCP客户端)连接到FileMaker数据库——只读查询, 模式发现和pandas驱动的分析。

它的作用

filemaker mcp是一个mcp服务器,它使AI助手能够实时访问您的 通过OData v4提供FileMaker数据。将其加载到Claude Desktop或Claude Code中并询问 用简单的英语回答有关数据的问题。

提供的工具:

  • fm_query_records --使用OData表达式搜索和筛选记录
  • fm_get_record --按主键获取单个记录
  • fm_count_records --使用可选筛选器计数记录
  • fm_list_tables --列出可用表格
  • fm_get_schema --发现字段名称、类型和键
  • fm_load_dataset --将记录拉入内存进行分析
  • fm_analyze --在加载的数据上运行groupby/sum/count/mean/min/max
  • fm_list_datasets --查看加载了哪些数据集

快速开始

先决条件

  • Python 3.12+
  • 紫外线 包管理器
  • 启用OData v4的FileMaker服务器
  • FM帐户 fmodata 扩展特权

安装

git clone https://github.com/nietsneuah/filemaker-mcp.git
cd filemaker-mcp
cp .env.example .env
# Edit .env with your FileMaker server details
uv sync

配置Claude桌面版

添加到您的Claude Desktop MCP配置 (~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上):

{
  "mcpServers": {
    "filemaker": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/filemaker-mcp", "filemaker-mcp"],
      "env": {
        "FM_HOST": "your-server.example.com",
        "FM_DATABASE": "your_database",
        "FM_USERNAME": "mcp_agent",
        "FM_PASSWORD": "your_password"
      }
    }
  }
}

跑

uv run filemaker-mcp

架构发现

启动时,服务器会自动从OData服务中发现您的表 文件。对于更丰富的模式(字段类型、主键、层),请安装 可选的 GetTableDDL FileMaker脚本--请参阅 docs/FM_ACCOUNT_SETUP.md.

分析

对于报告和摘要,请使用分析工具而不是原始查询:

  1. fm_load_dataset --将记录提取到pandas DataFrame中(自动分页)
  2. fm_analyze --立即运行聚合(无需额外的FM往返)

这将返回约200个令牌,而不是原始记录的约400K,效率要高得多 用于仪表板和趋势分析。

文档

许可证

GPL-3.0——见 许可证

作者

道格·豪恩斯坦/ FM地毯软件