RC

richlira/compass-mcp

效率工作流

本页由 AI 翻译,技术细节请以原文为准。 查看原文

34 stars 7 forks 质量 62 趋势 12

Compass 是一个 MCP 服务器,能在三个表面上为 Claude 提供共享的运行状态。在 Chat 添加任务,在 Code 中勾选,在 Cowork 中按项目筛选——数据相同,无需重新解释。

概览

Compass 是一个 MCP 服务器,能在三个表面上为 Claude 提供共享的运行状态。在 Chat 添加任务,在 Code 中勾选,在 Cowork 中按项目筛选——数据相同,无需重新解释。 Claude Chat、Cowork 和 Code 不共享状态。每次会话都是从零开始。在聊天里问“我在 Code 上完成了什么?”或者告诉 Cowork “这是这个项目的背景”,除非重新解释所有内容。 Compass 解决了这个问题。一个 MCP 服务器,三个表面都能看到,背后是普通的 markdown 文件。 它是连接你如何思考(聊天)、如何执行(Cowork)和如何构建(代码)的运营层。 添加到 ~/Library/Application Support/Claude/claude_desktop_config.json: 重启Claude桌面。三个标签页(聊天、Cowork、Code)都会看到Compass。 支持英语、西班牙语、西班牙英语等多种语言。Claude会自动将你的意图匹配到合适的工具。 创建包含 tasks.md 和 contexts/ 目录的 ~/compass-data/。可以安全地多次运行。

概述(AI 翻译)

克劳德·查特、Cowork和Code之间缺失的桥梁。

Compass 是一个 MCP 服务器,能在三个表面上为 Claude 提供共享的运行状态。在 Chat 添加任务,在 Code 中勾选,在 Cowork 中按项目筛选——数据相同,无需重新解释。

为什么?

Claude Chat、Cowork 和 Code 不共享状态。每次会话都是从零开始。在聊天里问“我在 Code 上完成了什么?”或者告诉 Cowork “这是这个项目的背景”,除非重新解释所有内容。

Compass 解决了这个问题。一个 MCP 服务器,三个表面都能看到,背后是普通的 markdown 文件。

这不是另一个待办事项应用。 它是连接你如何思考(聊天)、如何执行(Cowork)和如何构建(代码)的运营层。

安装

连接Claude桌面

加到~/Library/Application Support/Claude/claude_desktop_config.json:

重启Claude桌面。三个标签页(聊天、Cowork、Code)都会看到Compass。

用途

不用背命令。只要说话:

你说 指南针说
“设置我的工作区” init_workspace → 创建 ~/compass-data/
“添加任务:为登陆页撰写文案,截止日期为4月5日” add_task →添加到tasks.md

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

🧭 Compass MCP

The missing bridge between Claude Chat, Cowork, and Code.

Compass is an MCP server that gives Claude shared operational state across all three surfaces. Add a task in Chat, check it off in Code, filter by project in Cowork — same data, zero re-explaining.

┌───────────┐    ┌───────────┐    ┌───────────┐
│   Chat    │    │  Cowork   │    │   Code    │
└─────┬─────┘    └─────┬─────┘    └─────┬─────┘
      │                │                │
      └────────┬───────┴────────┬───────┘
               │                │
       ┌───────▼────────────────▼───────┐
       │         Compass MCP            │
       │                                │
       │   ┌──────────────────────┐     │
       │   │  ~/compass-data/     │     │
       │   │  tasks.md            │     │
       │   │  contexts/           │     │
       │   └──────────────────────┘     │
       └────────────────────────────────┘

Why?

Claude Chat, Cowork, and Code don’t share state. Each session starts from zero. There’s no way to ask in Chat “what did I finish in Code?” or tell Cowork “here’s the context for this project” without re-explaining everything.

Compass fixes that. One MCP server, visible to all three surfaces, backed by plain markdown files.

This is not another todo app. It’s the operational layer that connects how you think (Chat), how you execute (Cowork), and how you build (Code).

Install

git clone https://github.com/richlira/compass-mcp.git
cd compass-mcp
npm install
npm run build

Connect to Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "compass": {
      "command": "node",
      "args": ["/absolute/path/to/compass-mcp/build/index.js"]
    }
  }
}

Restart Claude Desktop. All three tabs (Chat, Cowork, Code) will see Compass.

Usage

No commands to memorize. Just talk:

You say Compass does
“Set up my workspace” init_workspace → creates ~/compass-data/
“Add task: write copy for landing page, deadline April 5” add_task → adds to tasks.md
“I finished the workshop slides” complete_task → marks it done
“What’s still pending?” get_tasks → returns filtered tasks
“Save context for Impact Lab: April 18, hackathon format” save_context → creates contexts/impact-lab.md
“What do we know about the workshop?” get_context → reads contexts/workshop.md

Works in English, Spanish, Spanglish — whatever. Claude matches your intent to the right tool automatically.

Tools

init_workspace

Creates ~/compass-data/ with tasks.md and contexts/ directory. Safe to run multiple times.

add_task

Adds a task to tasks.md.

  • title (required) — what needs to be done
  • tags — project or category tags (e.g. ["cancun", "marketing"])
  • deadline — due date
  • section — "active" (default) or "backlog"
在 GitHub 查看完整 README

安装

npx @modelcontextprotocol/inspector node build/index.js
新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "compass": { "command": "node", "args": ["/absolute/path/to/compass-mcp/build/index.js"] } } }