Hyperact MCP

Hyperact MCP

展示Hyperact博客内容的MCP服务器。展示一个用于列出文章的资源和一个按主题搜索相关帖子的工具，可以选择包含一个内容片段。服务器自动切换传输方式：默认情况下，本地MCP客户端为stdio，HTTP为 PORT 或 MCP_TRANSPORT=http 已设置。

需求

• Python 3.12+
• 紫外线 用于依赖关系管理

配置

• HYPERACT_API_BASE_URL （可选）：Hyperact MCP API的基本URL。默认为 https://hyperact.co.uk/api/mcp.

地方发展

uv sync            
uv run server.py   

在本地运行HTTP：

MCP_TRANSPORT=http PORT=8080 uv run server.py

码头工人

docker build -t hyperact-mcp .
docker run -p 8080:8080 -e PORT=8080 hyperact-mcp

部署到云运行（手动）

PROJECT_ID=your-project
REGION=your-region
IMAGE="gcr.io/${PROJECT_ID}/hyperact-mcp"

docker build -t "$IMAGE" .
docker push "$IMAGE"
gcloud run deploy hyperact-mcp \
  --image "$IMAGE" \
  --region "$REGION" \
  --port 8080 \
  --allow-unauthenticated

基础设施即代码（Pulumi+uv）

cd infra
uv sync
export PULUMI_BACKEND_URL="gs://mcp_state_bucket"   # bucket must already exist
pulumi stack init dev
# ensure Docker is running and gcloud auth is configured: gcloud auth configure-docker
pulumi up

Pulumi将构建并推送Docker镜像（默认： gcr.io//:)使用根 Dockerfile，然后部署Cloud Run+全局HTTPS负载均衡器。点 mcp.hyperact.co.uk 在导出的负载均衡器IP上，等待托管证书变为活动状态。