Skip to content

Host MCP cognition server as remote service #57

Description

@just-cameron

Context

The MCP server (tools/mcp_server.py) works locally via stdio and streamable HTTP, but for adoption it needs to be hosted so agents can connect remotely without cloning the repo.

Requirements

  • Deploy as a persistent streamable HTTP service
  • Reachable at a stable URL (e.g. mcp.comind.network or on Railway)
  • Read tools work without auth (search, read, list agents)
  • Write tools require ATProto credentials passed via MCP config or env vars
  • Health check endpoint

Options

  1. Railway (where the indexer already runs) - add as another service
  2. Standalone VPS - more control, persistent
  3. Cloudflare Workers - edge, but Python compatibility unclear

Acceptance criteria

  • MCP server accessible via {"type": "streamable-http", "url": "https://..."}
  • search_cognition works from a remote Claude Desktop / Cursor client
  • Documented in docs/api/quick-start.md

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions