Skip to main content
Glama
deenesjakoruzh
leandrosampaio

honcho-mcp-web

by leandrosampaio
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

honcho-mcp-web

Remote MCP server (HTTP/OAuth) exposing a self-hosted Honcho instance to claude.ai custom connectors and other MCP clients (Codex, Copilot, etc).

Two pieces run in the same container:

  • vendor/honcho-mcp (git submodule, upstream: devstroop/honcho-mcp) — the actual MCP tool implementations (peers, sessions, conclusions, workspace, dream/queue). Runs on localhost:3000, not exposed outside the container.

  • src/ (this repo) — a minimal single-user OAuth 2.1 (PKCE + Dynamic Client Registration) authorization server plus a token admin panel (/admin, HTTP Basic Auth), sitting in front of the upstream and proxying only authenticated requests to it. Each issued token (OAuth-issued for claude.ai, or a static token minted from /admin for CLI-style clients) is bound to an identity (workspace / peer / ai_peer) that the gateway enforces server-side on every tools/call.

Env vars

Variable

Default

Description

HONCHO_API_URL

http://api:8000

Self-hosted Honcho backend URL (passed to the upstream submodule)

HONCHO_API_KEY

—

API key for the Honcho backend

HONCHO_WORKSPACE_ID

default

Workspace the upstream operates in

PUBLIC_URL

http://localhost:8802

Public URL of this gateway (used in OAuth metadata)

GATEWAY_PASSWORD

—

Password for /authorize consent and /admin Basic Auth

HONCHO_PEER

leandro-sampaio

Default human peer shown in token forms

PORT

8802

Gateway listen port

Related MCP server: Remote MCP Server on Cloudflare

Updating the upstream

git submodule update --remote vendor/honcho-mcp
git add vendor/honcho-mcp
git commit -m "Atualiza devstroop/honcho-mcp"

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Remote MCP Server on

    sourabharsh
    F
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server implementation designed to run on Cloudflare Workers with integrated OAuth authentication. It enables hosting and securely accessing MCP tools remotely via SSE transport from clients like Claude Desktop.
    -

  • GPT MCP Service

    jmillpps
    F
    license
    Not graded
    quality
    D
    maintenance
    Private OAuth-backed MCP server for ChatGPT, supporting GPT Apps via MCP Streamable HTTP and GPT Actions via REST endpoints with OpenAPI 3.1.
    -

  • lighthouse-mcp-oauth

    Ulaklar
    F
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude.ai to connect to a Hermes MCP server via OAuth 2.1 authorization code flow with PKCE, acting as a reverse proxy and single-user authorization gateway.
    -