Better Auth Mcp Hono

What is Better Auth Mcp Hono

better-auth-mcp-hono is an MCP server project built using the HONC stack, which includes user authentication via GitHub and is powered by better-auth. It serves as an example repository for implementing remote MCP servers with Cloudflare.

Use cases

Use cases for better-auth-mcp-hono include building applications that require secure user login, managing user sessions, and integrating with other services that utilize the MCP protocol for data exchange.

How to use

To use better-auth-mcp-hono, ensure your MCP client supports remote servers. If so, you can directly input the server URL in the client interface. If not, configure your client using the mcp-remote package to specify the server URL in the configuration file.

Key features

Key features of better-auth-mcp-hono include user authentication through GitHub, integration with the HONC stack, and a structured project setup that includes database schema, middleware, and HTTP routes.

Where to use

better-auth-mcp-hono can be used in web applications that require user authentication and need to communicate with an MCP server. It is suitable for projects that leverage the HONC stack and Cloudflare infrastructure.

🪿 HONC Mcp Server

This is a project created with the create-honc-app template, extended to function as an MCP (Model Context Protocol) server with user authentication via GitHub, powered by better-auth.

Learn more about the HONC stack on the website or the main repo.
There is also an Awesome HONC collection with further guides, use cases and examples.

Access the remote MCP server from any MCP Client

If your MCP client has first class support for remote MCP servers, the client will provide a way to accept the server URL (https://better-auth-mcp.cjjdxhdjd.workers.dev/sse) directly within its interface.

If your client does not yet support remote MCP servers, you will need to set up its respective configuration file using mcp-remote to specify which servers your client can access.

Replace the content with the following configuration:

{
  "mcpServers": {
    "cloudflare": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://better-auth-mcp.cjjdxhdjd.workers.dev/sse"
      ]
    }
  }
}

Getting started

Make sure you have Neon set up and configured with your database.

Prerequisites

• Node.js and npm/yarn/pnpm
• A Neon database (or other PostgreSQL provider)
• A GitHub OAuth Application for user authentication.
• Cloudflare account and wrangler CLI installed and configured.

Environment Variables

Create a .dev.vars and .env(for better-auth schema generation) file for
local development (copied from .env.example) and set up secrets/variables in
your Cloudflare Worker environment for deployment.

Getting Started

1. Clone the repository.

git clone https://github.com/dead8309/better-auth-mcp-hono/

2. Install dependencies:

pnpm install

3. Set up environment variables: Create a .dev.vars and .env files from .env.example.

4. Run the development server:

pnpm dev

Deploying

Set your secrets (and any other secrets you need) with wrangler:

pnpm wrangler secret bulk .dev.vars

Deploy with wrangler:

pnpm  deploy