timepoint-mcp

Name: Timepoint MCP
Author: timepointai

Timepoint AI 时间知识平台的 MCP 服务器。

在线地址： mcp.timepointai.com

这是什么？

一个托管的 Model Context Protocol 服务器，为 AI 智能体提供对 Timepoint 生态系统的结构化访问：

搜索与浏览：包含 3,900 多个历史时刻和 500 万条以上边的因果图谱，跨越公元前 700 年至 2026 年
生成时间点 — 包含叙事、角色、对话和 AI 图像的丰富历史场景（第 2 阶段 — 开发中）
时间导航 — 在任何时刻向前/向后跳转，探索前因后果（第 2 阶段 — 开发中）
与历史人物聊天 — 与符合时代背景的人物进行情境化对话（第 2 阶段 — 开发中）
运行模拟 — 通过 SNAG 引擎进行多实体时间场景模拟（第 3 阶段 — 计划中）

适用于 Claude Desktop、Cursor、Windsurf、VS Code Copilot、Anthropic Agent SDK 以及任何兼容 MCP 的客户端。

获取 API 密钥

访问 timepointai.com 或在 X @timepointai 上联系我们以申请访问权限。

Clockchain 读取工具（搜索、浏览、时刻详情）无需身份验证即可使用，限制为 30 次请求/分钟。生成和模拟工具需要 API 密钥和积分。

快速入门

Claude Desktop

添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "timepoint": {
      "url": "https://mcp.timepointai.com/mcp",
      "headers": {
        "X-API-Key": "tp_mcp_..."
      }
    }
  }
}

Cursor / Windsurf

添加到 .cursor/mcp.json 或等效文件：

{
  "mcpServers": {
    "timepoint": {
      "url": "https://mcp.timepointai.com/mcp",
      "headers": {
        "X-API-Key": "tp_mcp_..."
      }
    }
  }
}

Anthropic Agent SDK

from claude_agent_sdk import Agent
from claude_agent_sdk.mcp import MCPServerRemote

agent = Agent(
    model="claude-sonnet-4-6",
    mcp_servers=[
        MCPServerRemote(
            url="https://mcp.timepointai.com/mcp",
            headers={"X-API-Key": "tp_mcp_..."},
        )
    ],
)
result = agent.run("What happened in Rome in 44 BC?")

本地开发

git clone https://github.com/timepointai/timepoint-mcp.git
cd timepoint-mcp
pip install -e .

# stdio transport (for Claude Desktop local)
python -m app.server --transport stdio

# HTTP transport (for remote testing)
python -m app.server --transport http --port 8000

可用工具

第 1 阶段（现已上线）— Clockchain 读取工具

工具	身份验证	描述
`search_moments`	可选	在时间因果图谱中搜索历史事件
`get_moment`	可选	通过规范路径获取历史时刻的完整详情
`browse_graph`	可选	浏览图谱层级 — 年、月、日、地点、事件
`get_connections`	可选	获取因果/主题连接：导致此事件的原因，以及此事件导致的结果
`today_in_history`	密钥	各个时代在今天发生的历史事件
`random_moment`	密钥	随机历史时刻，用于偶然发现
`graph_stats`	可选	节点/边计数、日期范围、来源分布

第 2 阶段（即将推出）— 生成工具

工具	积分	描述
`generate_timepoint`	5-10	生成包含场景、角色、对话、图像的历史时间点
`temporal_navigate`	2	从现有时间点在时间轴上向前/向后跳转
`chat_with_character`	1	在情境中与历史人物对话
`get_timepoint`	0	检索之前生成的时间点
`list_my_timepoints`	0	列出你生成的时间点
`get_credit_balance`	0	检查积分和使用情况

第 3 阶段（计划中）— 模拟工具

工具	积分	描述
`run_simulation`	10	运行 SNAG 时间模拟
`get_simulation_result`	0	获取模拟结果

定价

层级	价格	每月积分	速率限制
匿名	免费	—	30 次请求/分钟（仅限读取）
免费	免费	5 注册积分	60 次请求/分钟
探索者	$7.99/月	100	60 次请求/分钟
创作者	$19.99/月	300	300 次请求/分钟
工作室	$49.99/月	1,000	1,000 次请求/分钟

积分包也可作为一次性购买提供。

HTTP 端点

除了 /mcp 的 MCP 协议外，服务器还公开了以下端点：

方法	路径	描述
GET	`/`	落地页（智能体返回 JSON，浏览器重定向）
GET	`/health`	服务健康检查
GET	`/account/status`	身份验证状态和层级信息
POST	`/admin/create-key`	创建 API 密钥（需要管理员密钥）

架构

MCP Clients (Claude Desktop, Cursor, agents, SDKs)
        |
        | Streamable HTTP + X-API-Key
        v
   timepoint-mcp (mcp.timepointai.com)
   FastMCP + Starlette + asyncpg
        |
   -----+------+----------+
   |           |           |
   v           v           v
 Clockchain  Flash      Billing
 (graph)    (writer)   (Stripe/IAP)

MCP 服务器是一个轻量级的协调层。它通过 API 密钥验证请求，通过 Billing 解析用户层级，通过 Gateway 检查积分余额，将工具调用路由到相应的后端，并强制执行各层级的速率限制。它从不存储积分或订阅信息 — 这些由 Gateway 和 Billing 管理。

技术栈

Python 3.11+ 使用 FastMCP, Starlette, httpx, asyncpg
传输： 可流式传输 HTTP（生产环境），stdio（本地开发）
数据库： PostgreSQL（API 密钥 + 使用日志）
部署： Railway (Docker)

环境变量

# Downstream services
FLASH_URL=https://api.timepointai.com
FLASH_OUTBOUND_KEY=...  # key sent to Flash as X-Service-Key (was FLASH_SERVICE_KEY)
FLASH_ADMIN_KEY=...
CLOCKCHAIN_URL=...
CLOCKCHAIN_SERVICE_KEY=...
BILLING_URL=...
BILLING_SERVICE_KEY=...

# Database
DATABASE_URL=postgresql://...

# Server
PORT=8000

Timepoint 套件

重现过去。模拟未来。评估预测。积累图谱。

服务	类型	仓库	角色
API Gateway	私有	timepoint-api-gateway	身份验证权威 — JWT, OAuth (Apple/Google/GitHub), 积分, api.timepointai.com 的速率限制
Flash	开源	timepoint-flash	现实编写器 — 纯生成引擎（无身份验证），渲染扎实的历史时刻
Clockchain	开源	timepoint-clockchain	时间因果图谱 — 3,900+ 节点, 500万+ 边, MCP 端点, 24/7 增长
Pro	开源	timepoint-pro	SNAG 模拟引擎 — 时间模拟, TDF 输出, 训练数据
Proteus	开源	proteus	结算层 — 渲染未来的预测市场
TDF	开源	timepoint-tdf	数据格式 — 所有服务间的 JSON-LD 交换
SNAG Bench	开源	timepoint-snag-bench	质量认证 — 衡量渲染过程中的因果解析度
Billing	私有	timepoint-billing	支付处理 — Apple IAP + Stripe
MCP	公开	timepoint-mcp	MCP 服务器 — AI 智能体访问 Flash 和 Clockchain 的入口
Web App	私有	timepoint-web-app	浏览器客户端 app.timepointai.com
Landing	私有	timepoint-landing	营销网站 timepointai.com
iPhone App	私有	timepoint-iphone-app	iOS 客户端 — 移动端合成时间旅行
Skip Meetings	私有	skipmeetingsai	由 Flash 驱动的会议智能 SaaS

Timepoint MCP