How do I use YesDev MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@YesDev MCP Server log 3 hours on task #123 for implementing user authentication" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

🚀 YesDev MCP Server

定位：一款专为程序员自动登记每日开发工时的开源MCP工具，可以用在Cursor、VSCode等！

基于 YesDev项目管理工具，进行我的任务工时的登记和AI管理。重点解决两大矛盾：

📌 开发工程师忙于编程没空登记工时，而项目经理需要及时的工时投入和项目进度！
📌 企业老板或管理层想看到更真实、客观的开发工时，而"总"不相信人工填充的工时！

✨ 核心功能特性

📋 任务管理：
- 🤖 通过聊天方式，让AI帮你（程序员）自动根据当天开发登记任务和工时；
- 📝 快速查看和整理我当前的任务计划、待办工作清单；
📌 需求管理：
- 🔍 快速查看我目前的开发需求列表；
📅 项目管理：
- 📝 创建新项目和查看项目等常用操作；
🐛 缺陷管理：
- 🔧 快速查看我目前的Bug、工单和其他待处理的问题列表；
📅 日报：
- ✍️ AI自动汇总填写上报你（程序员）当天的日报；

🎯 如何使用？

你可以通过 npm 或 yarn 在全局安装本工具：

npm install -g @yesdevcn/yesdev-mcp-server

查看你本地后安装的目录位置，确保有执行权限：

$ which yesdev-mcp-server  
/Users/dogstar/.nvm/versions/node/v18.20.4/bin/yesdev-mcp-server

$ chmod +x /Users/dogstar/.nvm/versions/node/v18.20.4/bin/yesdev-mcp-server

2. 配置

免费注册 YesDev项目管理工具后获取你的YESDEV_ACCESS_TOKEN令牌。

⚡ Cursor MCP 配置

在 Cursor 的配置中添加以下内容：

{
  "mcpServers": {
    "yesdev-mcp-server": {
      "command": "node",
      "args": ["/path/to/bin/yesdev-mcp-server"],
      "env": {
        "YESDEV_ACCESS_TOKEN": "你的YesDev令牌"
      }
    }
  }
}

对于上面的路径，更换成你本地的安装路径，使用前面的 which yesdev-mcp-server 可获得。

例如，在Cursor中的提问：

请帮我把我今天做的新系统开发，在yesdev同步创建一个新项目。
然后，把我做的功能、界面需求，分别创建对应的需求。
最后，帮我录入对应的需求任务和工时。

调用MCP工具：

最后，AI在YesDev创建的新项目、需求、任务和工时：

💡 常用提示词

常用的提示词参考：

📝 请帮我创建一个新任务，并登记我今天的开发任务内容和工时到YesDev
📋 我今天有哪些YesDev任务？
📅 帮我写日报到YesDev
📅 请帮我把今天的开发工作，放到一个新项目，并帮我录入好对应的需求和任务工时。

🛠️ MCP开发

💻 本地开发环境要求

Node.js >= 18.0.0
npm 或 yarn 包管理器

🔧 安装

克隆仓库：

git clone https://github.com/yesdevcn/yesdev-mcp-server.git
cd yesdev-mcp-server

安装依赖：

npm install

⚙️ 配置

创建 .env 文件：

cp .env.example .env

配置环境变量：

# 获取方式：https://www.yesdev.cn/platform/account/accountInfo
YESDEV_ACCESS_TOKEN=填写你自己的令牌

🚀 开发

启动开发服务器：

npm run dev

📦 构建和运行

构建项目：

npm run build

启动服务器：

npm start

运行效果，类似如下：

$ npm run build && npm start

> yesdev-mcp-server@1.0.0 build
> tsc && chmod 755 dist/index.js

> yesdev-mcp-server@1.0.0 start
> node dist/index.js

正在注册工具...
YesDev MCP Server 已启动
已注册的工具: [
  'search_staff',          'get_workgroup_list',
  'get_my_profile',        'create_task',
  'get_task_detail',       'update_task',
  'remove_task',           'query_tasks',
  'get_my_task_list',      'get_project_task_list',
  'get_my_project_list',   'get_project_detail',
  'update_project',        'create_project',
  'update_project_status', 'update_project_time',
  'get_project_list',      'create_need',
  'update_need',           'get_need_detail',
  'get_need_detail_lite',  'remove_need',
  'query_needs',           'get_project_needs',
  'get_sub_needs',         'submit_daily_report',
  'get_my_problems',       'update_problem'
]

🛠️ 已实现的MCP工具列表

工具分类	工具名称	工具功能介绍	API 接口 (点击查看文档)
通用	`get_my_profile`	获取我的个人资料	`Platform.User.Profile`
	`search_staff`	根据员工姓名或工号搜索员工信息	`Platform.Staff.GetOrSearchStaffDropList`
	`get_workgroup_list`	获取所有的工作组列表	`Platform.Workgroup.GetWorkgroupDropList`
任务	`create_task`	创建一个新的YesDev任务	`Platform.Tasks.CreateNewTask`
	`get_task_detail`	获取指定任务的详细信息	`Platform.Tasks.GetTaskDetail`
	`update_task`	更新任务的信息，支持局部更新	`Platform.Tasks.UpdateTaskLite`
	`remove_task`	删除指定的任务	`Platform.Tasks.RemoveTask`
	`query_tasks`	根据多种条件查询任务列表	`Platform.Tasks.QueryTasks`
	`get_my_task_list`	获取我当前负责的、未完成的任务列表	`Platform.Tasks.GetTaskLeftSideMenu`
	`get_project_task_list`	获取指定项目的任务列表	`Platform.Tasks.SmartGetProjectTaskList`
项目	`create_project`	创建一个新的YesDev项目	`Platform.Projects.CreateNewProject`
	`get_project_detail`	获取指定项目ID的项目详细信息	`Platform.Projects.GetProjectDetail`
	`update_project`	局部更新指定ID的项目的信息	`Platform.Projects.UpdateProjectPart`
	`update_project_status`	更新指定ID的项目的状态	`Platform.Projects.UpdateProjectStatus`
	`update_project_time`	更新指定ID的项目的计划开始和结束时间	`Platform.Projects.UpdateProjectTime`
	`get_my_project_list`	获取我参与的、正在进行的项目列表	`Platform.Projects.GetProjectLeftSideMenu`
	`get_project_list`	获取全部项目列表，支持筛选、搜索、排序	`Platform.Projects.GetProjectList`
需求	`create_need`	创建一个新的YesDev需求	`Platform.PRD_Need.CreateNewNeed`
	`update_need`	按需更新指定ID的需求信息	`Platform.PRD_Need.UpdateNeedLite`
	`get_need_detail`	获取指定ID的需求的详细信息	`Platform.PRD_Need.GetNeedDetail`
	`get_need_detail_lite`	获取指定ID的需求的简化信息	`Platform.PRD_Need.GetNeedDetailLite`
	`remove_need`	删除指定ID的需求	`Platform.PRD_Need.RemoveNeed`
	`query_needs`	根据多种条件查询需求列表	`Platform.PRD_Need.GetNeedListMoreWhere`
	`get_project_needs`	获取指定项目的全部需求列表	`Platform.PRD_Need.GetProjectNeedListCanGroup`
	`get_sub_needs`	获取指定父需求的子需求列表	`Platform.PRD_Need.GetSubNeedList`
日报	`submit_daily_report`	提交或更新当天的日报内容	`Platform.Daily_Daily.AddOrUpdateDaily`
问题	`get_my_problems`	获取指派给我的、待我处理的问题列表	`Platform.Problem_Problem.GetProblemLeftSideMenu`
	`update_problem`	更新问题的信息	`Mobile.Problem_Problem.UpdatePartProblem`

🔗 相关项目

反馈和贡献

如果您在使用过程中遇到任何问题，或者有任何建议，欢迎随时通过以下方式联系我们：

在 GitHub Issues 中提出您的问题。

This server cannot be installed

A

license - permissive license

-

quality - not tested

C

maintenance

How are these scores calculated?

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

YesDev MCP Server