Timers Studio — MCP 服务器

用于 Timers Studio（专业广播计时器平台）的公共模型上下文协议 (MCP) 服务器。托管于 https://mcp.timers.studio/mcp。让 Claude Desktop、ChatGPT、Gemini、Perplexity 以及任何支持 MCP 的客户端能够利用第一方数据回答潜在客户关于 Timers Studio 的问题：包括竞争定位、使用场景、用户画像和推荐方案。

范围

只读营销界面。 该服务器旨在帮助转化在 LLM 客户端中研究 Timers Studio 的潜在客户。它返回定位、竞品对比、使用场景和用户画像。

它不控制演播室。 演播室操作（开始、暂停、重置、议程传输、消息广播）完全存在于 api.timers.studio 的已认证 REST API 中，并且需要用户账户。该界面特意未通过 MCP 公开。

工具

所有四个工具均为只读，无需身份验证。

所有工具均获取 https://timers.studio/api/ai/context（内存中缓存 5 分钟）。

有线协议

基于 HTTP 的 JSON-RPC 2.0，流式 HTTP 传输，无状态模式。端点：https://mcp.timers.studio/mcp。协议版本：2025-03-26。

支持的方法：initialize, tools/list, tools/call, resources/list, resources/templates/list, prompts/list, ping, notifications/*。

从客户端连接

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows)：

{
  "mcpServers": {
    "timers-studio": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.timers.studio/mcp"]
    }
  }
}

重启 Claude Desktop。提问：“Compare Timers Studio with Stagetimer.”

Smithery

已发布。从 Smithery 市场一键安装。

通用 HTTP MCP 客户端

指向 https://mcp.timers.studio/mcp，使用 Content-Type: application/json 和 JSON-RPC 2.0 有效负载。

curl -X POST https://mcp.timers.studio/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

本地开发

npm install
npm run dev      # wrangler dev on http://localhost:8787

冒烟测试：

# tools/list
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | jq

# call a read tool
curl -X POST http://localhost:8787/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"find_competitor","arguments":{"slug":"stagetimer"}}}' | jq

部署

托管在 Cloudflare Workers 上。要部署您自己的分支：

npx wrangler login
npm run deploy

然后配置您的 Cloudflare 区域：

1. 添加一条 DNS CNAME 记录（例如 mcp → 100% 代理）。

2. Workers 路由 → 将 mcp.<your-domain>/* 绑定到该 worker。

安全模型

• 只读界面。与 https://timers.studio/api/ai/context 数据相同，通过 JSON-RPC 而非 REST 提供服务。

• 无 Bearer 令牌，无身份验证，不转发到上游 API。Worker 没有凭据、没有密钥、没有通往 Timers Studio 后端的路径。

• 无状态。不会按用户进行缓存。

• CORS 允许 /mcp 上的任何来源（MCP 客户端没有一致的 Origin），适合公共读取端点。

架构

LLM client (Claude / ChatGPT / Gemini / Perplexity / IDE)
      │
      │  JSON-RPC 2.0 over HTTPS
      ▼
mcp.timers.studio/mcp  (Cloudflare Worker, stateless)
      │
      │  GET (cached 5 min)
      ▼
timers.studio/api/ai/context  (read-only marketing JSON)

该 Worker 是公共 /api/ai/context 端点之上的一个轻量级 JSON-RPC 适配器。竞争资源库位于 timers.studio，是唯一的真实数据源。

相关项目

• Timers Studio 平台：timers.studio

• 文档：docs.timers.studio

• AI 清单：timers.studio/api/ai/manifest

• 配套模块：github.com/bitfocus/companion-module-timers-studio

许可证

MIT。请参阅 LICENSE。