Qcqx Project Manage Mcp

io.github.qxchucklePublished by GitHub account qxchucklev1.0.0Updated Oct 24, 2026

qcqx-project-manage MCP Server — 将项目管理能力暴露给 AI Agent（Cursor、Claude Desktop 等）

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

Local MCP server that exposes a saved project list and Git repository scanning to AI agents such as Cursor or Claude Desktop.

What you can do
  • Search saved projects and groups by title, description or path, and read project details such as path, Git status and remote URL.
  • Scan directories for Git repositories, with depth limits, and list or update the configured scan folders and ignore patterns.
  • Add, update and remove projects and groups in the project list.
  • Read the current project list and app configuration as read-only resources.
When to use it
Useful when you keep a catalog of local projects and want an assistant to find, inspect or reorganize them, or to discover Git repositories under your folders without manual browsing.
Requirements
Runs locally over stdio; Node.js 18 or newer, installed globally from npm or run via npx. Configured in the client's MCP config file (Cursor, Claude Desktop, Claude Code). No accounts, API keys or environment variables are declared.
Before you install
Tools can change data: add, update and remove projects and groups, and overwrite the scan folder configuration. Removal of a node may affect the saved list, so confirm before letting an assistant modify it. Scanning reads local directory structures and Git metadata, including remote URLs.

Installation

In SourceWeft

  1. Open Qcqx Project Manage Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@qcqx/project-manage-mcp

qcqx-project-manage 的 MCP Server，通过 Model Context Protocol 将项目管理能力暴露给 AI Agent（Cursor、Claude Desktop 等）。

基于 @qcqx/project-manage-core 提供的核心逻辑，以 stdio 方式运行。

安装

bash
npm install -g @qcqx/project-manage-mcp

或通过 npx 免安装使用：

bash
npx @qcqx/project-manage-mcp

配置

Cursor

在项目或全局的 .cursor/mcp.json 中添加：

json
{  "mcpServers": {    "qcqx-project-manage": {      "command": "npx",      "args": ["-y", "@qcqx/project-manage-mcp"]    }  }}

Claude Desktop

编辑 claude_desktop_config.json：

json
{  "mcpServers": {    "qcqx-project-manage": {      "command": "npx",      "args": ["-y", "@qcqx/project-manage-mcp"]    }  }}

Claude Code

bash
claude mcp add qcqx-project-manage -- npx -y @qcqx/project-manage-mcp

Tools

search_projects

在已保存的项目列表中模糊搜索（按 title、description、path）。

参数类型必填说明
querystring是搜索关键词
type"project" | "group" | "all"否筛选节点类型，默认 all

scan_git_repos

扫描指定目录（或配置的默认目录）发现 Git 仓库。

参数类型必填说明
directoriesstring[]否要扫描的目录列表，省略时使用配置中的 gitProjectScanFolders
maxDepthnumber否最大递归深度，-1 为无限制

get_project_detail

获取项目详情（路径、Git 状态、remote URL 等）。

参数类型必填说明
idstring是项目节点 ID

add_project

将项目添加到项目列表。

参数类型必填说明
titlestring是项目名称
fsPathstring是项目在文件系统上的绝对路径
parentIdstring否父节点 ID，省略则添加到根级
descriptionstring否项目描述

remove_project

从项目列表移除节点。

参数类型必填说明
idstring是要移除的节点 ID

add_group

在项目列表中创建一个分组。

参数类型必填说明
titlestring是分组名称
parentIdstring否父节点 ID，省略则添加到根级

update_project

更新项目列表中的节点信息。

参数类型必填说明
idstring是节点 ID
titlestring否新标题
descriptionstring否新描述
fsPathstring否新路径

list_scan_folders

列出配置的 Git 项目扫描目录。无参数。

update_scan_folders

更新 Git 项目扫描目录配置。

参数类型必填说明
scanFolders(string | { path, desc?, category? })[]否扫描目录列表
ignoredFoldersstring[]否要忽略的文件夹名/glob 模式
scanNestedboolean否是否扫描嵌套 Git 项目
maxDepthnumber否最大递归深度，-1 为无限制

Resources

URI说明
projects://list当前项目列表（只读 JSON 快照）
projects://config当前应用配置

构建

bash
# 构建pnpm build
# 类型检查pnpm check-types
# 清理产物pnpm clean

环境要求

  • Node.js >= 18

许可

MIT

Source: packages/mcp/README.md at commit d997b2c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts