Adapter: Claris FileMaker (Data API)

Abierto Apto para principiantes
  • ¿Algo no está bien?
#1,405 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
72/100
Tipo de issue
Nueva funcionalidad
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
json, markdown, typescript, yaml
Área
api, backend-api-design, documentation

Línea de trabajo

Empieza con la sección "Add an adapter" de AGENTS.md y con docs/tool-definition.md, luego lee docs/connectors/login-token-auth.md para el flujo LOGIN_TOKEN. Genera la estructura con npm run adapter:new -- filemaker --region intl --auth LOGIN_TOKEN y añade herramientas de solo lectura para listar layouts, metadatos de layout, buscar registros y obtener un registro por id. Está terminado cuando node scripts/validate-adapters.mjs --warn pasa sin advertencias nuevas, el catálogo se regenera y intl/filemaker.live.spec.ts contiene aserciones estáticas.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

adapter-request good first issue help wanted

👋 A self-contained first contribution: one JSON adapter file, a spec and a logo. No need to know the rest of the codebase.

Why this one

In the last 30 days, the connector search on anythingmcp.com returned nothing for Claris FileMaker 2 times. People want it; nobody has built it yet.

The API

  • Docs: https://help.claris.com/en/data-api-guide/
  • Auth: a session token: POST /fmi/data/vLatest/databases/{database}/sessions with Basic credentials returns a token used as Bearer (this is what the LOGIN_TOKEN auth type is for, see docs/connectors/login-token-auth.md)
  • Category: Database

Suggested first tools (read-only)

list layouts, get layout metadata (field names), find records with a query, get one record by id. Read-only tools are enough for a first version; write tools can follow in a later PR.

How

Follow the six steps in AGENTS.md → Add an adapter and docs/tool-definition.md. The scaffold command for this one:

npm run adapter:new -- filemaker --region intl --auth LOGIN_TOKEN

Then node scripts/validate-adapters.mjs --warn, node scripts/regenerate-catalog.mjs, a intl/filemaker.live.spec.ts (static assertions always, live calls behind RUN_FILEMAKER_LIVE=1), node scripts/adapter-count.mjs --check and the logo. The walkthrough and past examples are in #982.

Done when

  • The adapter validates without new warnings and the catalog is regenerated.
  • Every tool has a description an AI can act on (what it returns, when to use it) and a response mapping that keeps the useful fields.
  • The PR says which calls you ran against a real account, or that you could not and built it from the docs.

Claim it

Comment here to claim it. A claim without a PR for 14 days goes back to the pool, no hard feelings. Sign the CLA when the bot asks.

Lenguaje dominante
TypeScript
Estrellas
856
Forks
82
Merge medio
6 h 34 min
PR fusionados (30 d)
362

Preparar el entorno

Este proyecto no incluye contenedor de desarrollo, Dockerfile ni guía de contribución, así que la configuración corre por tu cuenta: empieza por su README y consulta nuestra guía para la primera contribución para los pasos generales.

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de HelpCode-ai/anythingmcp

Todos los issues de HelpCode-ai/anythingmcp

Issues similares

Más issues de TypeScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.