Skip to main content
Glama
deenesjakoruzh
Bilaltariq98

Thesis

by Bilaltariq98
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Thesis

Selbst gehosteter Research-Arbeitsbereich pro Ticker für Privatanleger. Erfassen Sie Inhalte von überall über das PWA-Share-Sheet. Der Arbeitsbereich stellt einen MCP-Server bereit, sodass Ihr eigener Agent (Claude, ChatGPT, Codex CLI) die Synthese übernimmt. Single-User-MVP – Ihre Daten bleiben in Ihrem Cloudflare-Konto.

Research-Hilfe, keine Beratung. Der Agent schreibt; Sie entscheiden.

Architektur

┌─────────────────────────────────────────────────────────────┐
│  Browser / Mobile                                           │
│  ┌──────────────────────────────────────────────────────┐   │
│  │  PWA  (Vite + React + Tailwind)                      │   │
│  │  - Web Share Target  - Workspace tabs                │   │
│  │  - Tiptap rich text  - Component renderer            │   │
│  └────────────────────┬─────────────────────────────────┘   │
└───────────────────────┼─────────────────────────────────────┘
                        │  /api/*  /mcp
┌───────────────────────▼─────────────────────────────────────┐
│  Cloudflare Worker  (Hono)                                  │
│  ┌───────────────────────────────┐  ┌──────────────────┐    │
│  │  Workspace Durable Object     │  │  WorkspaceAgent  │    │
│  │  SQLite + embedding BLOB      │  │  DO (Slice 4)    │    │
│  │  30 MCP tools                 │  │  nightly cron    │    │
│  └───────────────────────────────┘  └──────────────────┘    │
│  ┌───────────────────────────────────────────────────────┐   │
│  │  Data providers                                       │   │
│  │  Yahoo  Stooq  EDGAR  Finnhub  FRED                  │   │
│  └───────────────────────────────────────────────────────┘   │
│  ┌──────────────┐  ┌────────────┐  ┌──────────────────────┐  │
│  │  R2 (docs)   │  │  KV cache  │  │  CF AI Gateway       │  │
│  └──────────────┘  └────────────┘  └──────────────────────┘  │
└─────────────────────────────────────────────────────────────┘

Future:
┌─────────────────────────┐
│  Auth app (Slice 5)     │
│  better-auth + Postgres  │
│  Docker → Fly.io        │
└─────────────────────────┘

Related MCP server: Signal8 MCP Server

Schnellstart

git clone <repo> && cd invest
npm install
cp apps/worker/.dev.vars.example apps/worker/.dev.vars
# Edit apps/worker/.dev.vars — set THESIS_BEARER_TOKEN, optionally FINNHUB_API_KEY + FRED_API_KEY

# Terminal 1 — worker on :8787
npm run dev:worker

# Terminal 2 — PWA on :5173 (proxies /api and /mcp to :8787)
npm run dev:pwa

Öffnen Sie http://localhost:5173. Fügen Sie in Einstellungen ein Bearer-Token hinzu (verwenden Sie den Wert aus .dev.vars).

Agent verbinden (BYOA)

GET /api/mcp-info gibt den MCP-Endpunkt, die Tool-Liste und Authentifizierungsanweisungen zurück. Die Einstellungsseite zeigt dieselben Informationen mit kopierfertigen URLs an.

  • Streamable HTTP (bevorzugt): POST /mcp, GET /mcp

  • Legacy-SSE: GET /mcp/sse, POST /mcp/messages

  • Auth: Authorization: Bearer <token> oder ?token=<token>

Umgebungsvariablen

Alle Geheimnisse werden für die lokale Entwicklung in apps/worker/.dev.vars abgelegt. Siehe apps/worker/.dev.vars.example.

Var

Erforderlich

Hinweise

THESIS_BEARER_TOKEN

Ja

Gemeinsames Geheimnis für alle API- und MCP-Anfragen

FINNHUB_API_KEY

Optional

Kostenlos auf finnhub.io – ermöglicht Fundamentaldaten, Gewinne, Nachrichten

FRED_API_KEY

Optional

Kostenlos auf fred.stlouisfed.org – ermöglicht Makro-Kacheln

STOOQ_API_KEY

Optional

2025-Captcha-Hürde – überspringen, um Yahoo-Fallback zu verwenden

ANTHROPIC_API_KEY

Slice 4

Erforderlich für nächtliche Läufe des eingebetteten Agents

CF_AIG_TOKEN

Slice 4

Cloudflare AI Gateway-Token

CF_ACCOUNT_ID

Slice 4

Ihre CF-Konto-ID

AGENT_MONTHLY_TOKEN_CAP

Optional

Standard 200000 Token/Monat pro Arbeitsbereich

Gelieferte Slices

Vollständiges Entscheidungsprotokoll und Slice-Verlauf: docs/roadmap/GRILL-ME.md

Slice

Beschreibung

Status

W0–W5

Grundlagen, Autorenschaft, Synthese, Perspektiven, Belege, Daten

✅

Slice 0

Stabilisierung, Stooq-Dokument, EDGAR-Wiederholung, theme-color

✅

Slice 1

Kompositions-Primitive – layout_json + set_layout MCP

✅

Slice 1.5

Vollständige Slot-Karte + erweitertes Komponenten-Vokabular

🔄

Slice 2

Abruf – Embeddings (BLOB-Cosinus), retrieve-Tool, Backfill

✅

Slice 3

Zeitlich – catch_up, reactivate_check, Catch-Up-UI

✅

Slice 4

Eingebetteter Agent – WorkspaceAgent DO, nächtlicher Cron, AI Gateway

✅

Slice 5

Auth – better-auth, Dockerisierte Auth-App

In Planung

Slice 6

Chat-Oberfläche

In Planung

Slice 7

Cross-Ticker-Vectorize-Tier

In Planung

Smoke-Tests

Kategorisierte Smoke-Tests befinden sich in smoke/.

# All Playwright specs (UI + E2E)
npm run smoke

# Individual shell scripts (worker API — no browser needed)
bash smoke/ingestion/capture.smoke.sh
bash smoke/claims/claims.smoke.sh
bash smoke/agent/agent.smoke.sh   # needs ANTHROPIC_API_KEY

Bereitstellung

Cloudflare Worker + PWA

# 1. Build PWA into apps/pwa/dist
npm run build:pwa

# 2. Set production secrets (one-time)
cd apps/worker
wrangler secret put THESIS_BEARER_TOKEN
wrangler secret put ANTHROPIC_API_KEY
wrangler secret put CF_AIG_TOKEN
wrangler secret put FINNHUB_API_KEY
wrangler secret put FRED_API_KEY

# 3. Deploy worker + PWA assets
wrangler deploy

Der Worker bedient die PWA von derselben Origin. /share-target, /mcp und /api/* sind alle First-Party.

Vollständiger Bereitstellungsleitfaden einschließlich Auth-App-Docker-Ziel, DNS und Post-Deploy-Smoke-Checks: docs/deployment.md.

Technologie-Stack

Ebene

Technologie

Worker-Laufzeit

Cloudflare Workers + Durable Objects (SQLite)

API-Framework

Hono

MCP

Handgefertigtes JSON-RPC über HTTP + SSE (30 Tools)

PWA

Vite 5 + React 18 + Tailwind 3

Rich-Text

Tiptap

Embeddings

Workers AI bge-small-en-v1.5 (384-dim, BLOB-Cosinus)

Agent

Einfaches Durable Object (WorkspaceAgent) + CF AI Gateway

Dokumente

R2 + document_captures-Join-Tabelle

Gemeinsame Typen

packages/shared (Zod)

Mitwirken

  1. Lesen Sie docs/STATUS.md – aktueller Stand + zukünftiger Plan

  2. Lesen Sie docs/architecture/v2-embedded-agent.md – v2-Design

  3. Führen Sie npm run typecheck aus, bevor Sie pushen

  4. Fügen Sie Smoke-Test-Abdeckung für neue Endpunkte in smoke/ hinzu

This server cannot be installed

A
license - permissive license
Not graded
quality - not tested
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • Finance MCP

    FlowLLM-AI
    A
    license
    C
    quality
    C
    maintenance
    Enables financial research and analysis through AI agents that combine web search, content crawling, entity extraction, and deep research workflows. Supports extracting stock/fund entities with security codes and conducting structured financial investigations.
    9
    24
    Apache 2.0
  • ROIC.ai Financial Data MCP Server by roicai

    ROIC.ai Financial Data MCPofficial

    roicai
    A
    license
    A
    quality
    B
    maintenance
    Enables AI assistants to access stock prices, financial statements, earnings call transcripts, and fundamental data for 60,000+ public companies via 25 read-only tools.
    25
    2
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Bilaltariq98/invest'

If you have feedback or need assistance with the MCP directory API, please join our Discord server