AI导哈

开发者辅助监控服务

Presence MCP是一款AI驱动的开发者辅助监控服务，能够实时检测开发者工作状态、记忆工作内容并预警潜在冲突，适用于代码开发和团队协作场景。

  • by CV-Minoura
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 CV-Minoura/presence-mcp

使用说明

出席MCP

当你陷入困境时，会进行检测。记得你昨天做了什么。在git冲突之前发出警告。

一个MCP服务器，让人工智能持续了解你的工作空间——这样克劳德在你问之前就注意到了问题。

它的作用

  1. 卡住检测 --当您反复在相同文件之间切换时，会注意到并建议采用不同的方法
  2. 会话内存 --自动记住你做了什么，所以“从我停止的地方继续”就行了
  3. Git冲突警告 --远程更改触摸您正在编辑的文件时发出警报

无需配置。安装、连接、忘记它。

安装

presence-mcp セットアップ手順
=====================================

【ステップ1】リポジトリをクローン（1行）
git clone https://github.com/CV-Minoura/presence-mcp.git C:\pmcp

【ステップ2】フォルダに移動
cd C:\pmcp

【ステップ3】依存パッケージをインストール＆ビルド
npm install
npm run build

【ステップ4】MCPサーバーをClaude Codeに登録（プロジェクトパスを変更すること）
claude mcp add presence node "C:\pmcp\dist\index.js" -e WORKSPACE_PATH=C:\path\to\your\project

【ステップ5】Claude Codeを再起動して確認
/mcp → presence が表示されれば完了

【オプション】Hookを設定するとプロンプト・ツール履歴が自動記録される
~/.claude/settings.json の "hooks" に以下を追加（パスを実際のクローン先に変更）:
{
  "hooks": {
    "UserPromptSubmit": [
      { "command": "node C:\\pmcp\\hooks\\prompt-capture.cjs", "timeout": 5000 },
      { "command": "node C:\\pmcp\\hooks\\session-inject.cjs", "timeout": 5000 }
    ],
    "PostToolUse": [
      { "command": "node C:\\pmcp\\hooks\\tool-capture.cjs", "timeout": 5000 }
    ]
  }
}

=====================================
動作環境: Node.js 18以上が必要

运作原理

存在与克劳德·科德一起默默地运行。它监视你的文件，跟踪git状态，并学习你的模式。当克劳德开始谈话时，它会打电话 presence_status 查看正在发生的事情——警报、最近的活动、会话背景——并自然地将这种意识融入对话中。

自适应阈值：当警报有用或嘈杂时，告知在线状态(presence_learn).它随时间调整检测灵敏度。你使用得越多，它就越聪明。

Web仪表板

打开 http://127.0.0.1:37800 --实时仪表板，带有传感器、警报、每小时活动图和用于搜索过去决策和会话的内存浏览器。

MCP工具

工具 目的
presence_status 当前状态：警报、活动、git、上下文
presence_summary 每日/每周工作总结及趋势分析
presence_recall 搜索过去的会议和决定
presence_learn 反馈回路——调整警报灵敏度

高级功能

Cognitive Capture

自动记录决策、任务摘要和学习。稍后用搜索 presence_recall 或者在Web UI中浏览。

工具 目的
presence_decision 记录架构决策
presence_digest 记录任务完成情况和学习情况
Team Awareness

启用后，检测与团队成员的文件冲突和分支冲突。分享关于已解决的卡住模式的知识。

{ "team": { "enabled": true, "directory": ".presence-team" } }
工具 目的
presence_team 团队成员状态和冲突
IDE Integration

随着 状态VSCode扩展，从编辑器中获取实时错误计数、调试状态和打开文件信息。

Configuration

创建 .presence.json 在项目根目录中（或使用 npx presence-mcp --init):

{
  "workspace": { "path": "." },
  "sensors": {
    "fileWatcher": { "enabled": true, "debounce_ms": 300 },
    "git": { "enabled": true, "auto_fetch": true }
  },
  "rules": {
    "stuck_detection": { "enabled": true, "window_minutes": 10, "min_switches": 5 }
  },
  "web": { "enabled": true, "port": 37800 },
  "storage": { "path": ".presence-data" }
}

环境变量：

变量 默认值 描述
WORKSPACE_PATH cwd() 项目根
PRESENCE_WEB_ENABLED true 仪表板打开/关闭
PRESENCE_WEB_PORT 37800 仪表板端口
PRESENCE_CONFIG - 自定义配置路径

建筑

Claude Code <--stdio--> Presence MCP <--http--> Web Dashboard
                              |
                    +---------+---------+
                    |         |         |
               Sensors    Rules    Memory
             file, git,  stuck,   sessions,
             ide, prompt remote   patterns,
                         team     cognitive

6个传感器，7个工具，3个资源，SQLite存储，自适应阈值。大约7000行TypeScript。除了Node.js标准库+MCP SDK之外，零运行时依赖。

数据和隐私

所有数据都保留在本地 .presence-data/presence.db.自动清除：会话30天，模式90天。敏感数据（API密钥、令牌）在存储前会自动剥离。

许可证

麻省理工学院

相关 MCP