📄 工具详情 ⚙️ 安装教程 📚 使用教程

能力标签

🔌

MCP工具

Dex

基于 Python · 让 AI 助手直接操作你的系统与工具

⭐ 432 Stars 🍴 119 Forks 💻 Python 📄 NOASSERTION 🏷 AI 8.0分

8.0AI 综合评分

ai-assistantanthropicclaude-codecursormcppython

⚙️ 配置说明 📺 TG 频道

✦ AI Skill Hub 推荐

Dex 是 AI Skill Hub 本期精选MCP工具之一。综合评分 8.0 分，整体质量较高。我们强烈推荐将其纳入你的 AI 工具库，帮助提升工作效率。

📚 深度解析

Dex 是一款基于 MCP（Model Context Protocol）标准协议的 AI 工具扩展。MCP 协议由 Anthropic 开发并开源，旨在建立 AI 模型与外部工具之间的标准化通信接口，目前已被 Claude Desktop、Claude Code、Cursor 等主流 AI 工具采纳。

通过安装 Dex，你的 AI 助手将获得额外的工具调用能力，可以用自然语言直接操控该工具的功能，无需学习复杂的命令行语法。MCP 工具的核心价值在于"一次配置，永久增强"——配置完成后，每次与 AI 对话时都可以无缝调用这些工具。

在技术实现上，MCP 工具通过标准的 JSON-RPC 协议与 AI 客户端通信，工具的功能以"工具列表"的形式暴露给 AI 模型，AI 可以按需调用。Dex 提供了结构化的工具调用接口，使 AI 模型能够精确地理解和使用每个功能点，显著降低 AI 在工具使用上的错误率。

与传统的 API 集成相比，MCP 工具的优势在于无需编写代码——用户只需在配置文件中添加几行 JSON，即可让 AI 获得全新能力。AI Skill Hub 将 Dex 评为 AI 评分 8.0 分，属于同类工具中的优质选择。

📋 工具概览

Dex 是一款遵循 MCP（Model Context Protocol）标准协议的 AI 工具扩展。通过 MCP 协议，它可以让 Claude、Cursor 等主流 AI 客户端直接访问和操作外部工具、数据源和服务，实现 AI 能力的无缝扩展。无论是文件操作、数据库查询还是 API 调用，都可以通过自然语言在 AI 对话中直接触发，极大提升生产效率。

GitHub Stars

⭐ 432

开发语言

Python

支持平台

Windows / macOS / Linux

维护状态

轻量级项目，按需更新

开源协议

NOASSERTION

AI 综合评分

8.0 分

工具类型

MCP工具

Forks

119

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理，如需查看完整原始文档请访问底部「原始来源」。

📌 核心特色

通过标准 MCP 协议与 Claude、Cursor 等主流 AI 客户端深度集成
提供结构化工具调用接口，显著降低 AI 集成复杂度
支持 Claude Desktop 和 Claude Code 无缝接入，开箱即用
可与其他 MCP 工具组合叠加，构建完整 AI 工作站
轻量无侵入设计，不影响现有系统架构

🎯 主要使用场景

在 Claude Desktop 对话中直接调用本地工具，实现 AI 与系统的深度联动
通过自然语言驱动复杂的多步骤自动化任务，代替繁琐手动操作
将多个 MCP 工具组合使用，构建个人专属 AI 工作站

以下安装命令基于项目开发语言和类型自动生成，实际以官方 README 为准。

安装命令

# 方式一：通过 Claude Code CLI 一键安装
claude skill install https://github.com/davekilleen/Dex

# 方式二：手动配置 claude_desktop_config.json
{
  "mcpServers": {
    "dex": {
      "command": "npx",
      "args": ["-y", "dex"]
    }
  }
}

# 配置文件位置
# macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
# Windows: %APPDATA%/Claude/claude_desktop_config.json

📋 安装步骤说明

确认已安装 Node.js（v18 或以上版本）
打开 Claude Desktop 或 Claude Code 的 MCP 配置文件
按「交给 Agent 安装 → Claude Desktop」标签中的 JSON 配置填入 mcpServers 字段
保存配置文件并重启 Claude 客户端
重启后，在对话中即可使用本工具

以下用法示例由 AI Skill Hub 整理，涵盖最常见的使用场景。

常用命令 / 代码示例

# 安装后在 Claude 对话中直接使用
# 示例：
用户: 请帮我用 Dex 执行以下任务...
Claude: [自动调用 Dex MCP 工具处理请求]

# 查看可用工具列表
# 在 Claude 中输入："列出所有可用的 MCP 工具"

以下配置示例基于典型使用场景生成，具体参数请参照官方文档调整。

配置示例

// claude_desktop_config.json 配置示例
{
  "mcpServers": {
    "dex": {
      "command": "npx",
      "args": ["-y", "dex"],
      "env": {
        // "API_KEY": "your-api-key-here"
      }
    }
  }
}

// 保存后重启 Claude Desktop 生效

📑 README 深度解析真实文档完整度 62/100 含工作流图查看 GitHub 原文 →

以下内容由系统直接从 GitHub README 解析整理，保留代码块、表格与列表结构。

Dex by Dave — Your AI Chief of Staff

A personal operating system powered by Claude. Strategic work management, meeting intelligence, relationship tracking, daily planning — all configured for your specific role. No coding required.

Companion to Episode 8 of The Vibe PM Podcast and the full blog post.

---

About the Command Line

You'll use something called a "command line" (or "Terminal" on Mac, "PowerShell" on Windows) during setup. This is a text-based way to give your computer instructions - think of it as typing commands instead of clicking buttons.

Don't worry if this feels unfamiliar. You'll copy and paste a few commands, press Enter, and you're done. Takes less than 2 minutes.

Step 3: Tell Dex About Your Role

In Cursor, look for a chat panel (usually on the right side of the screen). This is Claude - your AI assistant.

Here's exactly what to do:

1. Click inside the chat panel where it says "Message Claude..." or similar 2. Type exactly this: /setup 3. Press Enter - This invokes the setup skill 4. Wait ~30 seconds - First time setup needs to load everything (you'll see "Thinking..." while it works) 5. Press Enter again - Claude will now start asking questions 6. Answer each question naturally: - What's your role? (e.g., "CFO", "VP Sales", "Product Manager") - Company size? - What are your main focus areas?

Just type your answers like you're texting a colleague. Takes about 2 minutes total.

When it's done: You'll see confirmation that your workspace is configured. All folders, commands, and automation are now tailored to your specific role.

---

What's Included

Out of the box, working immediately:

8 core capabilities - Daily focus, relationship tracking, commitment management, career evidence, task sync that actually works, learning system, project health monitoring, system evolution (see jobs table above)
Complete planning system - Quarterly goals → weekly priorities → daily plans, all connected with rollup tracking
25+ ready-to-use skills - /daily-plan, /meeting-prep, /career-coach, /week-review and more - invoke with /skill-name
Role-based setup - 31 roles from CEO to IC, scaffolds appropriate folder structure and workflows. Onboarding MCP enforces validation (email domain required for Internal/External person routing) with session resume capability
Meeting intelligence - Process transcripts into structured notes with action items auto-synced. Works with Granola MCP (included), or paste transcripts from any source - system recognizes and processes them
Task management with unique IDs (Work MCP) - Tasks sync everywhere automatically (meeting notes, person pages, project files). Check off once, updates everywhere. Deduplication prevents doubles. Priority limits stop overcommit.
Career development coach - Captures evidence automatically, prepares reviews, assesses promotion readiness
Person & company pages - Relationship context for individuals + organization-level rollups (contacts, meetings, tasks)
Compound learning - Captures preferences and mistakes. Every session makes the next one better.
Self-upgrading system - Checks for new Claude Code features daily. When detected, explains what they mean for YOUR system and suggests implementations. Like having a concierge who reads release notes you'll never read.
Feature discovery - /dex-level-up suggests capabilities you haven't tried yet based on your usage patterns

Built-In Feature Discovery

You're likely using 20% of the system's capabilities because you don't know what you don't know.

Run /dex-level-up for progressive disclosure based on your actual usage. The system tracks which features you've used (stored locally in System/usage_log.md). When you run the command, it:

Analyzes your usage patterns - what you're already doing consistently
Identifies natural next steps - features that build on current habits
Shows 2-3 specific suggestions - never overwhelming, always relevant
Adapts to experience level - beginners get basics, power users get advanced features

Week 1: suggests daily review workflows. Week 3: suggests custom MCP integrations.

The system teaches you progressively. You learn what you need, when you need it.

---

All Platforms: "Could not install Python dependencies"

The installer tries two methods automatically. If both fail, your pip version might be too old.

Fix (reinstall into Dex's virtual environment):

python3 -m venv .venv
.venv/bin/pip install --upgrade pip
.venv/bin/pip install -r core/mcp/requirements.txt

Windows:

python -m venv .venv
.venv\Scripts\pip install --upgrade pip
.venv\Scripts\pip install -r core/mcp/requirements.txt

---

Setup Overview

Total time: ~10 minutes. Three steps: install tools → get the code → tell it your role.

Pick one of these to get started:

Option	Cost	What It Is
[Cursor](https://cursor.com)	Free tier works, or $20/month for Pro	An app with a built-in AI assistant (Claude). No separate Claude account needed.
[Claude Code Desktop](https://claude.ai/download)	Claude Pro $20/month	Anthropic's own app. Better experience — guaranteed self-learning hooks, automatic context loading.
Claude Code Terminal	Claude Pro $20/month	Same as Desktop but runs in Terminal (Mac) or PowerShell (Windows).

You do NOT go to claude.ai and type commands. You need one of the apps above. Cursor is the easiest starting point. Claude Code (Desktop or Terminal) gives you a better experience with self-learning hooks — setup instructions for those are further down this page.

Not sure which? Start with Cursor — it's free and gets you running in minutes. You can add or switch to Claude Code later.

---

Getting Started

What You'll Need to Install (One-Time)

1. Cursor - Download and install (free account works fine) 2. Git - Required for setup and updates - Mac: Installs automatically when needed (you'll see a prompt) - Windows: Download from git-scm.com/download/win 3. Node.js - Download the "LTS" version and install (this enables the system's automation features) 4. Python 3.10+ - Download and install (required for MCP servers and task sync) - Minimum version: Python 3.10 or newer - Windows users: ⚠️ During installation, check the box "Add Python to PATH" - this is critical - Mac users with old Python: If you have Python 3.9 or older, download fresh from python.org

All installers walk you through setup with default options.

Why Python 3.10+? The MCP SDK (Model Context Protocol) requires Python 3.10 or newer. This powers the Work MCP server that enables task sync - when you check off a task in a meeting note, it updates everywhere automatically (person pages, project files, Tasks.md).

Mac users: If this is your first time using command-line tools, macOS will prompt you to install "Command Line Developer Tools" during setup. Click Install when prompted - it's safe and required. Takes 2-3 minutes.

Check Your Setup (Optional)

Want to verify everything's ready? Open your command line: - Mac: Press Cmd+Space, type "Terminal", press Enter - Windows: Press Win+R, type "powershell", press Enter

Copy and paste this line exactly as you see it, then press Enter:

git --version

You should see a response like: git version 2.x.x (any version number is fine)

If you see "command not found": Download Git from git-scm.com, install it, then close and reopen your command line and try again.

---

Now copy and paste this line, then press Enter:

node --version

You should see a response like: v18.x.x or v20.x.x (must be version 18 or higher)

If you see "command not found": Download Node.js from nodejs.org, install it, then close and reopen your command line and try again.

---

Finally, check Python:

python3 --version

Windows users: Try python --version if python3 doesn't work.

You should see a response like: Python 3.10.x or higher (3.11, 3.12, etc.)

If you see Python 3.9 or older: The MCP SDK requires Python 3.10+. Download and install a newer version: - Mac/Windows: Download from python.org (get the latest stable version) - After installing, restart your terminal and check the version again

If you see "command not found": - Windows: Python likely isn't in your PATH. Reinstall from python.org and check "Add Python to PATH" during installation. Restart your terminal after. - Mac: Download Python from python.org, install it, then restart your terminal.

Why Python 3.10+ matters: It powers the MCP servers that sync tasks everywhere. Check off a task in a meeting note → it updates in your Tasks.md, person pages, and project files automatically. Python 3.9 and older won't work - you need 3.10 or newer.

---

That's the technical heavy lifting done. If you got through that, the rest is straightforward - just clicking buttons and answering questions.

Step 2: Run the Installer

Inside Cursor, you'll see a panel at the bottom (or go to View → Terminal). This is where you'll type commands.

Copy and paste this command and press Enter:

./install.sh

What's happening: This installs the automation that makes Dex work (task sync, career tracking, meeting intelligence). Takes 1-2 minutes. You'll see text scrolling - that's normal.

When it's done: You'll see your cursor blinking again, ready for the next command.

Your system Python stays clean: The installer creates a project-local virtual environment (.venv) inside your vault and installs all Python dependencies there — your system, Homebrew, or pyenv Python is never modified. No global installs, and no pipx needed.

⚠️ IMPORTANT: You're not done yet. Complete Steps 2B and 3 to finish setup.

Verify MCP servers: Cursor should automatically detect .mcp.json and enable the MCP servers. Look for the MCP icon in Cursor's bottom panel - you should see server names with green checkmarks.

If you see errors: The most common issue is Python dependencies not landing in Dex's virtual environment. Recreate it and reinstall — this keeps everything inside .venv and never touches your system Python:

python3 -m venv .venv
.venv/bin/pip install --upgrade pip
.venv/bin/pip install -r core/mcp/requirements.txt

Then restart Cursor.

<details> <summary><strong>Use Google Calendar? Connect it so Dex shows your meetings (Mac)</strong></summary>

If you use Google Calendar, you can have Dex show your real meetings when you run /daily-plan or ask "what's on my calendar today?" Two steps, one-time setup (Mac only):

Step 1 — Add Google to your Mac's Calendar app Open the Calendar app (the one that came with your Mac). In the menu bar, click Calendar → Add Account… → choose Google → sign in with your Google account. Your Google events will sync into Calendar. Dex reads from this app, so once Google is here, Dex sees your meetings.

Step 2 — Let Cursor use your calendar Open System Settings → Privacy & Security → Calendars. Turn Cursor on, then click Cursor and choose Full access (not "Add Only") so Dex can read your events. If macOS pops up asking "Cursor would like to access your calendars", click Allow.

That's it. The installer already set up the rest on Mac. Your meetings—including recurring ones like weekly 1:1s—will show on the correct days in Dex.

More detail and troubleshooting: Calendar_Setup.md (in your vault after setup). On Windows? Calendar connection is supported on Mac via Apple Calendar. We don't have Windows instructions in this repo yet.

</details>

⚠️ IMPORTANT: Complete Step 3 now to configure your role - this is what makes Dex work.

<details> <summary><strong>Troubleshooting: Common Setup Issues</strong></summary>

Windows: "python is not recognized" or "pip is not recognized"

This means Python wasn't added to your PATH during installation.

Fix:

Uninstall Python (Control Panel → Programs)
Download fresh installer from python.org
Run installer
⚠️ CHECK THE BOX: "Add Python to PATH" (on first screen)
Complete installation
Restart your terminal completely (close and reopen)
Run ./install.sh again

---

Option 1: Claude Desktop App

If you prefer visual interfaces over command line, use the Desktop app.

Requirements: - Claude Pro ($20/month) or Max ($100-200/month, 5-20x higher usage limits) subscription - free Claude accounts don't have access to Claude Code

Setup (2 minutes):

Download from claude.ai/download
Install and open the app
Log in with your Claude Pro or Max account
Click the Code tab (top left)
Select your Dex folder to start a session

That's it. Hooks run automatically - session start context loads, person details inject when mentioned, mistake patterns surface.

Desktop app benefits: - Visual interface - See all sessions, review changes with side-by-side diffs - Multiple parallel sessions - Click "+ New session" to work on different tasks simultaneously - Built-in integrations - Connect Calendar, Slack, GitHub without manual configuration - Same guaranteed hooks as command line

---

Option 2: Command Line

For those comfortable working in Terminal (Mac) or PowerShell (Windows), Claude Code runs from the command line.

Requirements: - Claude Pro ($20/month) or Max ($100-200/month, 5-20x higher usage limits) subscription - free Claude accounts don't have access to Claude Code

Step 1: Install

You can install from your system's native terminal or from within Cursor (easiest since you're already there).

Option A: Native Terminal/PowerShell

Mac - Terminal:

curl -fsSL https://claude.ai/install.sh | bash

Windows - PowerShell:

irm https://claude.ai/install.ps1 | iex

Option B: From Inside Cursor (Easiest)

In Cursor, go to View → Terminal (opens a panel at the bottom)
Copy and paste the command for your system:

Mac:

curl -fsSL https://claude.ai/install.sh | bash

Windows:

irm https://claude.ai/install.ps1 | iex

The installer automatically updates itself in the background to keep you current.

Step 2: Authenticate

In your terminal (native or Cursor's), run:

claude auth

This opens your browser. Log in with your Claude Pro or Max account.

Step 3: Start Claude Code

From your terminal, navigate to your Dex folder and run claude.

Note: Folder name depends on how you got the code: - If you cloned via Git: folder is named dex - If you downloaded ZIP: folder is named dex-main

Mac:

cd ~/Documents/dex        # or dex-main if you downloaded ZIP
claude

Windows:

cd %USERPROFILE%\Documents\dex        # or dex-main if you downloaded ZIP
claude

---

Need help? See official Claude Code setup docs for troubleshooting.

Which option? Desktop app for visual interface. Command line for those comfortable in Terminal/PowerShell. Both give you the same guaranteed hooks capability.

---

Obsidian Integration (Optional)

Dex works great with Obsidian for visual graph navigation.

Why Obsidian? - See your entire knowledge system as connected nodes - Click any reference to jump instantly between people, projects, meetings - Bidirectional task sync (check boxes in Obsidian → syncs everywhere)

Enable Obsidian mode:

/dex-obsidian-setup

What this does: - Converts all references to clickable wiki links - Generates optimized Obsidian config (optional) - Enables bidirectional sync daemon (optional)

Time: 1-2 minutes even for large vaults Safe: Creates git backup before any changes

New to Obsidian? Watch this beginner's guide (5 min).

Obsidian is completely optional - Dex works perfectly in Cursor/terminal alone. Some users love the graph visualization for navigating their knowledge, others prefer the speed of terminal/Cursor. Both are first-class experiences.

Learn more: See Obsidian_Guide.md

---