timps

本地服务

github.com/TIMPSs记忆与知识06 周前更新

代码仓库

关于 timps

timps 是面向 Claude、Cursor 和 Windsurf 等编码助手的持久记忆 MCP 服务，提供跨会话回忆、矛盾检测，以及代码、决策和开发者信号跟踪工具。

主要功能

01存储和检索持久记忆
02检测已记录立场之间的矛盾
03跟踪决策与承诺事项
04识别错误模式和架构漂移
05监测倦怠信号
06查询因果图与知识图谱

适用场景

01在后续会话中回忆项目上下文
02将新陈述与过往立场进行比对
03跟踪决策和待完成承诺
04检查代码风险与倦怠信号

MCP 相关

timps 通过 MCP 提供记忆和开发者智能工具。它可以代理到 TIMPS HTTP 服务，也可在本地模式下直接运行 MemoryEngine。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "sandeeprdy1729-timps": {
      "command": "npx",
      "args": [
        "-y",
        "@timps-ai/timps-mcp"
      ],
      "env": {
        "TIMPS_URL": "<TIMPS_URL>",
        "TIMPS_MEMORY_URL": "<TIMPS_MEMORY_URL>",
        "TIMPS_API_KEY": "<TIMPS_API_KEY>",
        "TIMPS_PROJECT_PATH": "<TIMPS_PROJECT_PATH>"
      }
    }
  }
}

启动命令npx -y @timps-ai/timps-mcp

需要配置的环境变量

TIMPS_URLURL of the TIMPS MemoryServer (e.g. http://localhost:4100). If not set, uses local file-based memory.

TIMPS_MEMORY_URLURL of the TIMPS MemoryServer for memory operations. Set to same as TIMPS_URL when using the full stack.

TIMPS_API_KEY密钥API key for authenticating with TIMPS MemoryServer. Generate via POST /auth/key on the server.

TIMPS_PROJECT_PATHProject path for local memory storage. Defaults to current working directory.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@timps-ai/timps-mcp2.0.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
message	string	是	要发送给 TIMPs 的消息
username	string	否	可选用户名

详细介绍

@timps-ai/timps-mcp — 为 Claude、Cursor 和 Windsurf 提供持久记忆

45 个 MCP 工具，可为你的 AI 编码助手提供跨会话的持久记忆，支持矛盾检测、Bug 模式识别、倦怠监控、架构漂移检测，以及 22 层记忆锻造。

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

添加到你的 AI 工具

Claude Code（`~/.claude.json`）

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

Cursor（`~/.cursor/mcp.json`）

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

Windsurf（`~/.codeium/windsurf/mcp_config.json`）

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

两种模式

模式	配置	后端
SERVER（默认）	设置 `TIMPS_URL`	代理到 TIMPS HTTP 服务
LOCAL	未设置 `TIMPS_URL`	直接使用 `@timps-ai/memory-core` MemoryEngine

45 个 MCP 工具

核心记忆

timps_chat、timps_get_memories、timps_store_memory

矛盾检测

timps_check_contradiction、timps_get_positions

决策智能

timps_check_regret、timps_log_decision、timps_simulate_decision、timps_log_past_decision

倦怠监控

timps_burnout_analyze、timps_record_signal

Bug 与代码模式

timps_warn_bug_pattern、timps_record_bug、timps_check_tech_debt、timps_record_incident

API 知识

timps_lookup_api、timps_record_api_quirk

会议与承诺

timps_extract_commitments、timps_get_pending_commitments、timps_complete_commitment

关系

timps_record_mention、timps_relationship_check

不断发展的宣言

timps_ingest_manifesto_signal、timps_get_manifesto

Chronos Veil（因果图）

timps_chronos_ingest、timps_chronos_query、timps_chronos_stats

NexusForge（知识图谱）

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

架构与风险

timps_detect_architecture_drift、timps_predict_bug_risk、timps_get_incident_timeline、timps_check_deployment_risk

开发者智能

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+ 智能

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 层工具

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

环境变量

变量	默认值	描述
`TIMPS_URL`	—	TIMPS 服务 URL（SERVER 模式）
`TIMPS_USER_ID`	`1`	用户 ID

示例

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"

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。