出席MCP
当你陷入困境时，会进行检测。记得你昨天做了什么。在git冲突之前发出警告。
一个MCP服务器，让人工智能持续了解你的工作空间——这样克劳德在你问之前就注意到了问题。
它的作用
- 卡住检测 --当您反复在相同文件之间切换时，会注意到并建议采用不同的方法
- 会话内存 --自动记住你做了什么，所以“从我停止的地方继续”就行了
- 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 Presence MCP Web Dashboard
|
+---------+---------+
| | |
Sensors Rules Memory
file, git, stuck, sessions,
ide, prompt remote patterns,
team cognitive6个传感器，7个工具，3个资源，SQLite存储，自适应阈值。大约7000行TypeScript。除了Node.js标准库+MCP SDK之外，零运行时依赖。
数据和隐私
所有数据都保留在本地 .presence-data/presence.db.自动清除：会话30天，模式90天。敏感数据（API密钥、令牌）在存储前会自动剥离。
许可证
麻省理工学院