Timepoint MCP
Officialtimepoint-mcp
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 的客户端。
Related MCP server: Bi-Temporal Knowledge Graph MCP Server
获取 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 读取工具
工具 | 身份验证 | 描述 |
| 可选 | 在时间因果图谱中搜索历史事件 |
| 可选 | 通过规范路径获取历史时刻的完整详情 |
| 可选 | 浏览图谱层级 — 年、月、日、地点、事件 |
| 可选 | 获取因果/主题连接:导致此事件的原因,以及此事件导致的结果 |
| 密钥 | 各个时代在今天发生的历史事件 |
| 密钥 | 随机历史时刻,用于偶然发现 |
| 可选 | 节点/边计数、日期范围、来源分布 |
第 2 阶段(即将推出)— 生成工具
工具 | 积分 | 描述 |
| 5-10 | 生成包含场景、角色、对话、图像的历史时间点 |
| 2 | 从现有时间点在时间轴上向前/向后跳转 |
| 1 | 在情境中与历史人物对话 |
| 0 | 检索之前生成的时间点 |
| 0 | 列出你生成的时间点 |
| 0 | 检查积分和使用情况 |
第 3 阶段(计划中)— 模拟工具
工具 | 积分 | 描述 |
| 10 | 运行 SNAG 时间模拟 |
| 0 | 获取模拟结果 |
定价
层级 | 价格 | 每月积分 | 速率限制 |
匿名 | 免费 | — | 30 次请求/分钟(仅限读取) |
免费 | 免费 | 5 注册积分 | 60 次请求/分钟 |
探索者 | $7.99/月 | 100 | 60 次请求/分钟 |
创作者 | $19.99/月 | 300 | 300 次请求/分钟 |
工作室 | $49.99/月 | 1,000 | 1,000 次请求/分钟 |
积分包也可作为一次性购买提供。
HTTP 端点
除了 /mcp 的 MCP 协议外,服务器还公开了以下端点:
方法 | 路径 | 描述 |
GET |
| 落地页(智能体返回 JSON,浏览器重定向) |
GET |
| 服务健康检查 |
GET |
| 身份验证状态和层级信息 |
POST |
| 创建 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=8000Timepoint 套件
重现过去。模拟未来。评估预测。积累图谱。
服务 | 类型 | 仓库 | 角色 |
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 |
许可
专有。版权所有 2026 Timepoint AI。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Company brain for AI agents — temporal knowledge graph search, exploration, and durable memory.
AI-verified knowledge base with trust scoring, temporal facts, and skill cards.
Bi-temporal AI memory. 56 tools, knowledge graph, semantic search. EU-hosted, free tier.
Turn grounded AI answers into trusted comparisons, plans, timelines, and decision views.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to build and query temporally-aware knowledge graphs from conversations and data. Supports adding episodes, searching entities and facts, and maintaining persistent memory across interactions.11Apache 2.0
- FlicenseNot gradedqualityNot gradedmaintenanceGives AI agents persistent memory with bi-temporal tracking, automatically extracting entities from natural language and enabling time-travel queries to understand facts as they existed at any point in history.2-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to build and query temporally-aware knowledge graphs from conversations and data, maintaining persistent memory of entities, relationships, and facts across interactions.-
- FlicenseNot gradedqualityDmaintenanceEnables querying 10,000 years of historical social-complexity data from the Seshat Global History Databank through 9 tools, allowing counterfactual analysis and comparison of polities in natural language.1-