timepoint-mcp

Name: Timepoint MCP
Author: timepointai

Timepoint AI 시간적 지식 플랫폼을 위한 MCP 서버입니다.

라이브: mcp.timepointai.com

이것은 무엇인가요?

AI 에이전트에게 Timepoint 생태계에 대한 구조화된 액세스를 제공하는 호스팅된 Model Context Protocol 서버입니다:

검색 및 탐색: 기원전 700년부터 2026년까지 3,900개 이상의 역사적 순간과 500만 개 이상의 엣지로 구성된 인과 관계 그래프
시간 포인트 생성: 서사, 인물, 대화 및 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 req/min (읽기 전용)
무료	무료	5 가입 크레딧	60 req/min
탐험가	$7.99/월	100	60 req/min
제작자	$19.99/월	300	300 req/min
스튜디오	$49.99/월	1,000	1,000 req/min

크레딧 팩은 일회성 구매로도 제공됩니다.

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 사용)
전송: Streamable 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 서버 — Flash 및 Clockchain에 대한 AI 에이전트 액세스
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