关键词

项目管理构思追踪工作流程仪表板Claude集成

使用说明

项目简介

claude-MCP-idea-project-tracker 是一个项目构思管理工具，它利用 Model Context Protocol (MCP) 技术，允许用户通过 Claude 桌面应用与本地服务器进行交互，实现项目想法的捕捉、管理和可视化。该工具能够扫描项目文件夹，将项目信息存储在数据库中，并通过 Streamlit 仪表板展示项目状态和进展。用户可以与 Claude 自然语言对话，添加新的项目想法或完善现有想法，极大地提升项目管理的效率和体验。

主要功能点

  • 项目扫描: 自动扫描用户指定的文件夹，识别进行中的项目，并将项目信息存储到本地数据库。
  • 交互式构思管理: 用户可以通过与 Claude 对话，使用自然语言添加、修改和查询项目想法。只需在对话中说 “add to idea store” 即可将讨论内容总结并保存到数据库。
  • 全面的项目数据: 支持管理项目名称、类别、优先级、阶段、风险等级、业务影响等多种项目属性。
  • 可视化仪表板: 提供基于 Streamlit 的交互式仪表板，以图表和指标的形式展示项目数据，帮助用户直观了解项目概况和进展。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/pathakmukul/claude-MCP-idea-project-tracker.git
cd claude-MCP-idea-project-tracker

  2. 设置后端 (Backend): 进入 'src' 目录并安装 Node.js 依赖：

    cd src
npm install

  3. 设置数据库: 运行 SQL 脚本创建数据库表结构：

    sqlite3 ../data/project_tracker.db < db/schema.sql

    (注意：在 'src' 目录下执行，数据库文件 'project_tracker.db' 将在项目根目录的 'data' 文件夹下创建)

  4. 安装 Python 依赖: 在项目根目录下创建并激活 Python 虚拟环境 (可选但推荐)，然后安装 Python 依赖：

    python3 -m venv venv
source venv/bin/activate  # 或根据你的系统使用不同的激活命令
pip install -r requirements.txt

服务器配置

要将此 MCP 服务器与 Claude 桌面应用连接，您需要更新 Claude 的配置文件 'claude_desktop_config.json'。

  1. 打开 Claude 桌面应用的配置文件 'claude_desktop_config.json'。该文件通常位于 '~/Library/Application Support/Claude/' (macOS) 或 '%APPDATA%/Claude/' (Windows)。

  2. 在 'servers' 列表中添加一个新的服务器配置，内容如下：

    {
    "name": "idea-bot-server",  // MCP 服务器名称，可以自定义
    "command": "npm",        // 运行服务器的命令，这里使用 npm
    "args": ["run", "start"], // 传递给 npm 的参数，运行 package.json 中定义的 start 脚本
    "cwd": "./src"             // MCP 服务器的工作目录，指向仓库 src 目录
}

    配置参数说明:

    • 'name': 服务器名称，在 Claude 客户端中用于标识和选择该服务器，可以自定义。
    • 'command': 启动服务器进程的命令，这里使用 'npm'，因为服务器是通过 'npm run start' 启动的。
    • 'args': 传递给 'command' 的参数，'["run", "start"]' 指示 npm 运行 'package.json' 中定义的 'start' 脚本。
    • 'cwd': 关键参数，指定服务器进程的工作目录为克隆仓库的 'src' 目录。Claude 客户端会在这个目录下执行 'command' 和 'args'。请确保路径正确，以便服务器能够找到相关文件并正常启动。

    完整的 'claude_desktop_config.json' 示例 (仅 servers 部分):

    {
  "servers": [
    // ... 其他已有的服务器配置 ...
    {
      "name": "idea-bot-server",
      "command": "npm",
      "args": ["run", "start"],
      "cwd": "./src"
    }
  ]
}

  3. 保存并关闭 'claude_desktop_config.json' 文件。

基本使用方法

  1. 启动 MCP 服务器: 配置完成后，Claude 桌面应用应该能够自动连接到您配置的 MCP 服务器。您也可以在 Claude 客户端的设置中手动连接或重启服务器。

  2. 运行仪表板: 在项目根目录下，打开新的终端窗口，运行 Streamlit 仪表板：

    streamlit run src/dashboard.py

    仪表板将在浏览器中打开，通常地址为 'http://localhost:8501'。

  3. 与 Claude 交互: 在 Claude 桌面应用中，您可以开始与 Claude 对话，并使用自然语言管理您的项目想法。例如：

    • 添加想法: 您可以说类似于 “Let's add a new project idea to the store. Project name is 'Develop mobile app', category is 'Software', priority is high.”
    • 查询想法: 您可以说 “Get me project ideas in 'Research' category.”
    • 可视化数据: 您可以说 “Visualize project data by category.”

    服务器端 (idea-bot-server) 会解析 Claude 的请求，并调用相应的工具 (例如 'idea_bot_add', 'idea_bot_get', 'idea_artifact') 来操作数据库或生成可视化数据，并将结果返回给 Claude。仪表板则提供了一个直观的界面来查看和分析项目数据。

注意: 首次使用前，可能需要先运行 'src/db/setup.ts' 脚本来初始化数据库。但根据安装步骤，'npm install' 之后应该已经可以运行 'npm run start' 启动服务器，并自动进行数据库初始化。如果遇到数据库相关问题，可以尝试手动运行 'npm run db-setup' (查看 'src/package.json' 中的 scripts 定义)。

信息

分类

生产力应用

访问项目