FMS ODATA MCP

FileMaker服务器OData MCP

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

提供FileMaker服务器OData 4.01 API集成的模型上下文协议（MCP）服务器 适用于Claude Desktop、Windsurf、Cursor和Cline等人工智能助手。

特性

• 🔌 19个MCP工具 用于FileMaker数据库操作
• 🔍 数据库发现 -探索表、字段和元数据
• 📊 CRUD操作 -创建、读取、更新和删除记录
• 🔐 安全连接 -SSL支持自签名证书
• 💾 连接管理 -保存和重用数据库连接
• 📝 OData 4.01标准 -完整的查询功能（$filter、$select、$orderby等）

快速开始

安装

# Via NPM (recommended)
npm install -g filemaker-odata-mcp

# Or local development
git clone https://github.com/fsans/FMS-ODATA-MCP.git
cd FMS-ODATA-MCP
npm install
npm run build

部署模式

1.MCP服务器模式（默认）

适用于支持MCP的AI助手（Claude Desktop、Windsurf、Cursor、Cline）。

Claude桌面设置

1. 找到您的Claude配置文件：

- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json

1. 添加MCP服务器：

{
  "mcpServers": {
    "filemaker": {
      "command": "npx",
      "args": ["-y", "filemaker-odata-mcp"],
      "env": {
        "FM_SERVER": "https://your-filemaker-server.com",
        "FM_DATABASE": "YourDatabase",
        "FM_USER": "your-username",
        "FM_PASSWORD": "your-password",
        "FM_VERIFY_SSL": "true"
      }
    }
  }
}

1. 用于自签名SSL证书，set FM_VERIFY_SSL 到 "false"

1. 重新启动克劳德桌面

风帆/光标设置

全局安装时，将自动检测服务器。对于本地开发，请添加到MCP配置中。

2.独立HTTP服务器模式

作为可从任何应用程序访问的独立HTTP服务器运行：

# Set environment variables for HTTP mode
export MCP_TRANSPORT=http
export MCP_PORT=3333
export MCP_HOST=0.0.0.0  # Listen on all interfaces

# Run the server
filemaker-odata-mcp

服务器将于启动 http://localhost:3333 具有以下端点：

• MCP端点: http://localhost:3333/mcp （JSON-RPC 2.0的POST请求）
• 健康检查: http://localhost:3333/health
• 服务器信息: http://localhost:3333/mcp （GET请求）

HTTP客户端请求示例

curl -X POST http://localhost:3333/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

HTTPS模式

export MCP_TRANSPORT=https
export MCP_PORT=3443
export MCP_CERT_PATH=/path/to/cert.pem
export MCP_KEY_PATH=/path/to/key.pem

集成示例

Python示例：

import requests

# List available tools
response = requests.post("http://localhost:3333/mcp", json={
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
})
tools = response.json()

# Query records
response = requests.post("http://localhost:3333/mcp", json={
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
        "name": "fm_odata_query_records",
        "arguments": {
            "table": "Contacts",
            "filter": "City eq 'New York'"
        }
    }
})

JavaScript示例：

// Connect to FileMaker
const response = await fetch('http://localhost:3333/mcp', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        jsonrpc: '2.0',
        id: 1,
        method: 'tools/call',
        params: {
            name: 'fm_odata_connect',
            arguments: {
                server: 'https://your-server.com/fmi/odata/v4',
                database: 'Contacts',
                user: 'admin',
                password: 'secret',
                verifySsl: false
            }
        }
    })
});

3.Docker部署

选项A：使用 start.sh （推荐）

包括 start.sh 脚本处理来自的构建、凭证注入 .env，以及容器生命周期：

git clone https://github.com/fsans/FMS-ODATA-MCP.git
cd FMS-ODATA-MCP
cp .env.example .env
# Edit .env with your FileMaker credentials and set MCP_TRANSPORT=http, MCP_HOST=0.0.0.0
./start.sh

该脚本将构建TypeScript，构建Docker镜像，删除任何现有容器，并启动一个新的容器。日志会自动跟踪。

选项B：使用Docker Run

# Clone and build
git clone https://github.com/fsans/FMS-ODATA-MCP.git
cd FMS-ODATA-MCP
npm run build
docker build -t filemaker-odata-mcp:latest .

# Run the container
docker run -d \
  --name filemaker-odata-mcp \
  -p 3333:3333 \
  -e FM_SERVER=https://your-filemaker-server.com \
  -e FM_DATABASE=YourDatabase \
  -e FM_USER=your-username \
  -e FM_PASSWORD=your-password \
  -e FM_VERIFY_SSL=false \
  -e MCP_TRANSPORT=http \
  -e MCP_HOST=0.0.0.0 \
  -v ~/.fms-odata-mcp:/home/mcp/.fms-odata-mcp \
  filemaker-odata-mcp:latest

重要提示： 集 MCP_HOST=0.0.0.0 在容器中运行时。使用 localhost 仅绑定到容器的环回接口，并使端口无法从外部访问。

选项C：使用Docker Compose

1. 克隆和构建：

git clone https://github.com/fsans/FMS-ODATA-MCP.git
cd FMS-ODATA-MCP
npm run build

1. 配置环境：

cp docker-compose.yml my-docker-compose.yml
# Edit my-docker-compose.yml with your FileMaker credentials

1. 启动服务器：

docker-compose -f my-docker-compose.yml up -d

选项D：使用HTTPS编写Docker

# Start with Nginx reverse proxy for HTTPS
docker-compose -f docker-compose.yml --profile https up -d

将您的SSL证书放入 ./ssl 目录：

• ssl/cert.pem -SSL证书
• ssl/key.pem -SSL私钥

Docker功能

• 健康检查 -服务器状态的自动监控
• 持久连接 -装载卷以保存连接配置
• 非root用户 -安全最佳实践
• 高山 Linux -图像大小小（~50MB）
• 信号处理 -使用愚蠢的初始化进行优雅的关机

访问服务器

运行后，访问服务器：

• HTTP： http://localhost:3333
• HTTPS（使用Nginx）： https://localhost

检查运行状况端点：

curl http://localhost:3333/health

4.Dify整合

将此服务器用作MCP工具 迪菲:

1. 以HTTP模式启动服务器（请参阅上面的Docker部署）
2. 在Dify中，添加一个新的MCP工具：

- 运输： streamable_http - 网址： http://host.docker.internal:3333/mcp （如果Dify在同一主机上的Docker中运行）

1. 不需要身份验证标头

注： 如果Dify返回403错误，请检查您的SSRF代理配置。Dify使用Squid代理来防止SSRF攻击——必须将端口3333添加到 Safe_ports ACL在 squid.conf.

第一步

连接后，在Claude中尝试以下提示：

What tables are in my FileMaker database?

Show me the first 5 records from the Contacts table

Find all contacts where LastName equals "Smith"

Create a new contact with name "John Doe" and email "john@example.com"

文档

• 快速参考 -单页设置指南
• 提示示例 -完整的提示参考
• Claude桌面设置 -详细配置
• 风帆设置 -IDE集成指南
• **** -带生产示例的完整Docker指南

可用工具

需求

• Node.js 18.0.0或更高
• FileMaker服务器 启用了OData API
• FileMaker帐户 具有适当的访问权限

环境变量

FileMaker连接

HTTP/HTTPS传输

OData查询语法

服务器支持OData 4.01查询选项：

$filter   - Filter records (e.g., "Age gt 18")
$select   - Select specific fields
$orderby  - Sort results
$top      - Limit results
$skip     - Skip records (pagination)
$expand   - Include related records
$count    - Include total count

示例提示：

Get contacts where Age is greater than 18

Show only Name and Email fields from Contacts

Sort contacts by LastName in descending order

Get the first 10 contacts, skip the first 20

贡献

看 贡献.md 发展指南。

许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

支持

• 问题:
• 讨论:

更新日志

看 版本历史。

______________________________________________________________________

制作❤️ 面向FileMaker和AI社区