Flarelink
Build on the Flarelink stack — Cloudflare auth, D1, and R2 — from your AI coding tools.
Open source Open in the app JSON README (API)
About
Build on the Flarelink stack — Cloudflare auth, D1, and R2 — from your AI coding tools.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- flarelink-dev
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Stars
- 1
- Last push
- 2026-06-17T22:20:57Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 03:02:48
- Updated
- 2026-08-29 03:02:48
- Origin id
io.github.flarelink-dev/mcp
README
# @flarelink/mcp
An [MCP](https://modelcontextprotocol.io) server that teaches your AI coding tool to build correctly on the **Flarelink stack** — Cloudflare auth (better-auth + KV sessions), D1, and R2 — from inside Cursor, Claude Code, Windsurf, and anything else that speaks MCP.
It hands the agent the security and cost rules up front (user-scoping, identifier-safe SQL, KV sessions, presigned R2) so the generated code is right the first time, instead of the agent guessing and you debugging.
## Install
No install needed — run it with `npx`. Add it to your tool's MCP config:
**Claude Code**
```bash
claude mcp add flarelink -- npx -y @flarelink/mcp
```
**Cursor / Windsurf / Claude Desktop** (`mcp.json` / config):
```json
{
"mcpServers": {
"flarelink": {
"command": "npx",
"args": ["-y", "@flarelink/mcp"],
"env": { "FLARELINK_API_KEY": "flk_…" }
}
}
}
```
The `FLARELINK_API_KEY` is **optional**. Without it you still get all the
knowledge + scaffolding tools. With it, the **management tools** (below) can
drive your actual Flarelink projects. Mint a key at
[dash.flarelink.dev → API keys](https://dash.flarelink.dev).
## Tools
| Tool | What it gives the agent |
| --- | --- |
| `flarelink_stack_overview` | The stack, cardinal rules, and deployment shapes. Read first. |
| `flarelink_scaffold` | How to bootstrap a complete working app (clone / one-click deploy) + file map. |
| `flarelink_list_patterns` | The catalog of canonical code patterns. |
| `flarelink_get_pattern` | Copy-pasteable code for one recipe (auth setup, route guards, identifier-safe D1, R2 upload/presign, wrangler bindings, SDK usage). |
| `flarelink_sdk_reference` | `@flarelink/client` signatures + return shapes (auth / storage / db). |
| `flarelink_cost_patterns` | Cloudflare cost-optimization guidance, with targeted hints for the feature you describe. |
It also exposes the stack guide as a resource (`flarelink://stack-guide`) you can attach as context.
### Management tools (need `FLARELINK_API_KEY`)
Drive your actual Flarelink projects from the editor. These route through the Flarelink dashboard API and act exactly as you would in the UI.
| Tool | What it does |
| --- | --- |
| `flarelink_whoami` | Verify the key; show the user + active connection/project. |
| `flarelink_list_projects` | List projects on the active Cloudflare connection. |
| `flarelink_list_databases` | List the project's D1 databases. |
| `flarelink_query_database` | Run a (parameterized) SQL statement against a project D1. |
| `flarelink_list_buckets` | List the project's R2 buckets. |
Without a key they return a clear "set `FLARELINK_API_KEY`" message. The key has the same access as your Flarelink login — treat it like a password.
## License
MIT. Part of [Flarelink](https://flarelink.dev) — the dashboard for the Cloudflare developer stack.