widescreen-research

glassBead-tc/widescreen-research

3.3

If you are the rightful owner of widescreen-research and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Widescreen Research is a comprehensive Model Context Protocol (MCP) server designed to enhance research capabilities with real-time web search, academic paper access, and company intelligence.

Tools
8
Resources
0
Prompts
0

widescreen-research

Go CI

Bidirectional MCP server orchestrating an army of research drones on Cloud Run in GCP.

Repo status

  • Primary implementation: Go (coordinator and drone)
  • Examples: Node (under examples/node)

Clone

git clone https://github.com/glassBead-tc/widescreen-research.git
cd widescreen-research

Quickstart (Go)

go version  # require 1.23+
go mod download

# terminal 1
LOG_LEVEL=debug go run ./cmd/coordinator

# terminal 2
DRONE_TYPE=research EXA_API_KEY=your-local-only-key LOG_LEVEL=debug go run ./cmd/drone

Open http://localhost:8080 and GET /health.

Docker (Go)

docker build -t widescreen/coordinator:dev .
docker run --rm -p 8080:8080 widescreen/coordinator:dev

Deploy to Cloud Run (Go)

Preferred: inject secrets from Secret Manager. Example:

gcloud run deploy widescreen-coordinator \
  --source . \
  --region=us-central1 \
  --allow-unauthenticated \
  --set-env-vars=LOG_LEVEL=info \
  --set-secrets=EXA_API_KEY=exa_api_key:latest

Node examples (optional)

The Node projects live under ./examples/node/ and are provided as examples only.

  • Requires Node 18+ LTS
  • See each example's README for usage

Architecture and design

See for the canonical architecture, roles, and protocols.

Directory layout

  • cmd/coordinator: Go coordinator service (binary)
  • cmd/drone: Go drone worker (binary)
  • pkg/...: Reusable Go packages
  • examples/node/...: Node example MCP servers and templates

Operations

  • Endpoints: GET / (info), GET /health (readiness)
  • Logging: structured logs; control via LOG_LEVEL
  • Recommended: enable OpenTelemetry to Cloud Monitoring (future work)

Contributing

See CONTRIBUTING.md (coming soon). Please run go fmt/go vet and tests locally before submitting PRs.