Cloudflare SYWO

Cloudflare MCP Server

typescript

GitHub Stars

typescript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "seek-your-way-out-cloudflare-sywo-mcp-server": {
      "command": "cloudflare-sywo-mcp",
      "args": [
        "--stdio"
      ],
      "env": {
        "CLOUDFLARE_API_TOKEN": "YOUR_API_TOKEN",
        "CLOUDFLARE_ACCOUNT_ID": "YOUR_ACCOUNT_ID",
        "CLOUDFLARE_D1_DATABASE_ID": "YOUR_DATABASE_ID",
        "CLOUDFLARE_D1_DATABASE_NAME": "YOUR_DATABASE_NAME"
      }
    }
  }
}

You run a lightweight MCP server that lets MCP-compatible clients query your Cloudflare D1 database and run SQL queries. It’s designed for easy setup, secure credential handling, and cross‑platform use so you can query tables or execute SQL from your MCP-enabled tooling.

How to use

Start by running the MCP server locally or in your development environment. The server exposes a stdio interface that you can connect to from your MCP client configuration. You’ll provide credentials via environment variables so your tokens and IDs aren’t embedded in code.

With the server running, you can perform common actions such as listing the tables in your Cloudflare D1 database and running arbitrary SQL queries through your MCP client. Use the client’s capabilities to send requests to the server; for example, you can request the list of tables and then run queries against the database, receiving the raw D1 payload in return.

To configure a client, set the environment variables required by the server. These credentials are read by the MCP server at startup and do not require inclusion in code. The variables you provide are used to authenticate against Cloudflare D1 and access the specific database.

How to install

npm install -g cloudflare-sywo-mcp-server

Prerequisites you need before installation: Node.js 18 or newer, a Cloudflare Account ID, a Cloudflare D1 Database ID and name, and an API token with D1:Edit permissions.

Additional configuration and notes

Credential management options include providing credentials directly in your MCP configuration, using a .env file for development, or setting system environment variables for advanced setups. Never expose API tokens in source control. Rotate tokens if they are ever exposed.

If you want to use the server with VS Code, you can configure the MCP server in your settings to run the stdio interface with the required environment variables. The configuration uses the command name cloudflare-sywo-mcp and passes the --stdio flag.

Security and troubleshooting

Ensure your Cloudflare API token has the necessary permissions (D1:Edit) and that the Account ID, Database ID, and Database Name are correct. If you encounter connection issues, verify all environment variables are set correctly and that credentials are not exposed.

If you see JSON parsing or startup issues, update to the latest server version and ensure you are using a compatible Node.js runtime. For Windows compatibility, use the supported command and environment setup to avoid script host errors.

Example usage patterns

List all tables in your D1 database and then run a SQL query through your MCP client by issuing the appropriate requests to the Cloudflare D1 backend via the MCP server. The server handles the authentication and communication with Cloudflare D1, returning the results to your client.

Available tools

d1_list_tables

Returns an array of table names from the Cloudflare D1 database.

d1_query

Executes a SQL query and returns the raw D1 response payload.

Built by

VeilStrat

AI signals for GTM teams