widescreen-research

双向MCP服务器，在GCP的Cloud Run上管理一支研究无人机部队。

仓库状态

• 主要实现：Go（协调器和无人机）
• 示例：Node（位于examples/node下）

克隆

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

快速开始（Go）

go version  # 需要1.23及以上版本
go mod download

# 终端1
LOG_LEVEL=debug go run ./cmd/coordinator

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

打开http://localhost:8080并访问/health。

Docker（Go）

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

部署到Cloud Run（Go）

推荐：从Secret Manager注入密钥。示例如下：

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示例（可选）

Node项目位于./examples/node/下，仅作为示例提供。

• 需要Node 18+ LTS
• 查看每个示例的README以了解用法

架构与设计

查看project_spec.md以获取规范架构、角色和协议。

目录布局

• cmd/coordinator：Go协调器服务（二进制）
• cmd/drone：Go无人机工作者（二进制）
• pkg/...：可重用的Go包
• examples/node/...：Node示例MCP服务器和模板

运营

• 端点：GET /（信息），GET /health（就绪性）
• 日志记录：结构化日志；通过LOG_LEVEL控制
• 推荐：启用OpenTelemetry到Cloud Monitoring（未来工作）

贡献

查看CONTRIBUTING.md（即将推出）。在提交PR之前，请本地运行go fmt/go vet和测试。 </中文翻译>