Timps

io.github.Sandeeprdy1729由 GitHub 账号 Sandeeprdy1729 发布v2.0.3更新于 Oct 24, 2026

Persistent memory with contradiction detection, burnout monitoring, and 69 intelligence tools.

已验证STDIO仅桌面知识与记忆开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，为编程助手提供跨会话的持久记忆，并带有矛盾检测、缺陷模式提醒、决策与倦怠分析等工具。

可以做什么
存储、检索并基于持久记忆对话，未设置服务器地址时使用本地文件存储。检测新说法与过往立场之间的矛盾，并记录、模拟和回顾决策。提醒已知缺陷模式，记录缺陷与事故，检查技术债并预测缺陷风险。跟踪 API 怪癖、会议与承诺，以及对话中提到的人物。查询因果、知识与突触图谱，检查架构漂移与部署风险，审计记忆来源与冲突。
适用场景
适合希望编程助手记住此前会话、在新说法与过去表述矛盾时给出提醒，或在代码库工作中调出过往缺陷模式与决策的场景。
运行要求
以 npm 包形式在本地通过 stdio 运行，需先全局安装并具备 Node.js。可选设置 TIMPS_URL 指向 TIMPS MemoryServer；未设置时记忆以本地文件形式存放在 TIMPS_PROJECT_PATH（默认为当前工作目录）。TIMPS_API_KEY 用于向服务器认证，需通过服务器的认证接口生成。TIMPS_USER_ID 默认为 1。
安装前请注意
TIMPS_API_KEY 是密钥，不应写入共享配置。相关工具会写入记忆、决策、事故和承诺，在服务器模式下这些数据会发送到所配置的 TIMPS_URL 端点，因此只应指向可信服务器。README 示例配置使用本地服务器地址和默认用户 ID。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Timps，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@timps-ai/timps-mcp — Persistent Memory for Claude, Cursor, and Windsurf

[npm] [License: MIT]

45 MCP tools that give your AI coding assistant persistent memory across sessions — contradiction detection, bug patterns, burnout monitoring, architecture drift, and 22-layer memory forge.

bash
npm install -g @timps-ai/timps-mcp

Add to your AI tool

Claude Code (~/.claude.json)

json
{  "mcpServers": {    "timps": {      "command": "timps-mcp",      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }    }  }}

Cursor (~/.cursor/mcp.json)

json
{  "mcpServers": {    "timps": {      "command": "timps-mcp",      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }    }  }}

Windsurf (~/.codeium/windsurf/mcp_config.json)

json
{  "mcpServers": {    "timps": {      "command": "timps-mcp",      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }    }  }}

Two modes

ModeConfigBackend
SERVER (default)TIMPS_URL setProxies to TIMPS HTTP server
LOCALNo TIMPS_URLUses @timps-ai/memory-core MemoryEngine directly

45 MCP Tools

Core Memory

timps_chat, timps_get_memories, timps_store_memory

Contradiction Detection

timps_check_contradiction, timps_get_positions

Decision Intelligence

timps_check_regret, timps_log_decision, timps_simulate_decision, timps_log_past_decision

Burnout Monitoring

timps_burnout_analyze, timps_record_signal

Bug & Code Patterns

timps_warn_bug_pattern, timps_record_bug, timps_check_tech_debt, timps_record_incident

API Knowledge

timps_lookup_api, timps_record_api_quirk

Meetings & Commitments

timps_extract_commitments, timps_get_pending_commitments, timps_complete_commitment

Relationships

timps_record_mention, timps_relationship_check

Living Manifesto

timps_ingest_manifesto_signal, timps_get_manifesto

Chronos Veil (Causal Graph)

timps_chronos_ingest, timps_chronos_query, timps_chronos_stats

NexusForge (Knowledge Graph)

timps_nexus_ingest, timps_nexus_query, timps_nexus_stats, timps_nexus_graph

SynapseMetabolon

timps_synapse_ingest, timps_synapse_query, timps_synapse_stats, timps_synapse_graph, timps_synapse_consolidate

Architecture & Risk

timps_detect_architecture_drift, timps_predict_bug_risk, timps_get_incident_timeline, timps_check_deployment_risk

Developer Intelligence

timps_get_velocity_trend, timps_get_context_switches, timps_record_learning, timps_get_shared_decisions, timps_record_review_pattern

ChronosForge

timps_temporal_query, timps_chrono_foresight, timps_chrono_consolidate

L7+ Intelligence

timps_skill_shadow, timps_log_question, timps_curriculum_plan, timps_observe_culture, timps_codebase_culture, timps_record_contribution, timps_mark_contributor_active, timps_institutional_memory

22-Layer Tools

timps_verify_engram_chain, timps_false_memory_check, timps_explain_provenance, timps_resolve_conflict, timps_audit_memory, timps_register_trigger, timps_reveal_bias, timps_infer_schemas

Env Variables

VariableDefaultDescription
TIMPS_URL—TIMPS server URL (SERVER mode)
TIMPS_USER_ID1User ID

Examples

You: "I'm going to use setTimeout for sync here"→ timps_warn_bug_pattern → ⚠️ Bug pattern match (race condition, hit before in src/queue.ts)
You: "Remote teams don't work"→ timps_check_contradiction → ⚠️ CONTRADICTION 82% — 47 days ago you said "Remote works best"

来源：timps-mcp/README.md，提交 6e17ae9

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v2.0.3最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分