Dversum

io.github.dversum由 GitHub 账号 dversum 发布v2.0.0更新于 Oct 24, 2026

Manage clients, projects, tasks, invoices, time tracking & calendar in dVersum.

已验证STDIO仅桌面效率与工作流金融商业与电商

概览

AI 生成的概览

dVersum 官方 MCP 服务器，让助手在 dVersum 工作区中管理客户、项目、任务、工时、发票、报价与日历。

可以做什么
  • 查询、新建、修改和删除客户、联系人、项目、看板列、任务、子任务、评论、标签与领域
  • 记录、修改和删除工时，启动与停止计时器，查看工时统计
  • 创建、编辑、发送和跟踪发票、报价、定期发票、催款单、贷项通知与取消发票
  • 登记收款，查看收入与增值税汇总，审批收到的发票，管理供应商并预览 DATEV 导出数据
  • 管理日历事件、团队缺勤与休假统计
  • 处理页面、白板、文件夹、文件与分享链接，以及通知、组织成员和全局搜索
适用场景
适合以 dVersum 管理业务、希望助手代拟发票或报价、更新项目看板、记录工时、查看财务数据或在各处检索信息而无需切换应用的场景。
运行要求
通过 npm 包以 npx 在本地运行，或用 Docker 以 HTTP 传输在 3100 端口运行。需要 DVERSUM_API_URL 基础地址和取自 dVersum 设置的 DVERSUM_API_TOKEN JWT，并能访问该 API。
安装前请注意
该令牌可访问整个业务工作区，请勿放入共享配置。许多工具会写入、发送或删除数据：发票和催款单可邮件发给客户，可登记收款、邀请或移除成员，并删除文件、文件夹和页面。执行前请确认操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Dversum，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@dversum/mcp-server

Official Model Context Protocol (MCP) server for the dVersum business management API. Lets AI assistants like Claude Desktop, Cursor, and Windsurf interact with your dVersum workspace — managing clients, projects, tasks, invoices, time tracking, and more.

Quick Start

Claude Desktop

Add this to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

json
{  "mcpServers": {    "dversum": {      "command": "npx",      "args": ["-y", "@dversum/mcp-server"],      "env": {        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",        "DVERSUM_API_TOKEN": "your-jwt-token"      }    }  }}

Cursor / Windsurf

Add to your MCP settings:

json
{  "mcpServers": {    "dversum": {      "command": "npx",      "args": ["-y", "@dversum/mcp-server"],      "env": {        "DVERSUM_API_URL": "https://api.dversum.com/api/v1",        "DVERSUM_API_TOKEN": "your-jwt-token"      }    }  }}

Docker (Production)

Quick start

bash
cd mcp-server
# Create .env fileecho "DVERSUM_API_URL=https://api.dversum.com/api/v1" > .envecho "DVERSUM_API_TOKEN=your-jwt-token" >> .env
# Rundocker compose up -d

The server starts on port 3100 with a health check at /health and the MCP endpoint at /mcp.

Build & run manually

bash
docker build -t dversum-mcp .docker run -d \  -p 3100:3100 \  -e DVERSUM_API_URL=https://api.dversum.com/api/v1 \  -e DVERSUM_API_TOKEN=your-jwt-token \  --name dversum-mcp \  --restart unless-stopped \  dversum-mcp

Connect remote MCP to Claude Desktop

Once the Docker container is running, point Claude Desktop to the remote endpoint:

json
{  "mcpServers": {    "dversum": {      "url": "http://your-server:3100/mcp"    }  }}

Environment Variables

VariableRequiredDescription
DVERSUM_API_URLYesBase URL of your dVersum API (e.g. https://api.dversum.com/api/v1)
DVERSUM_API_TOKENYesYour JWT authentication token
MCP_TRANSPORTNostdio (default) or http (for Docker/remote)
MCP_PORTNoHTTP port when using http transport (default: 3100)

Available Tools (152)

Clients (5)

ToolDescription
list_clientsList all clients with pagination
get_clientGet client details
create_clientCreate a new client
update_clientUpdate client details
delete_clientDelete a client

Contacts (5)

ToolDescription
list_contactsList all contacts
get_contactGet contact details
create_contactCreate a new contact
update_contactUpdate contact details
delete_contactDelete a contact

Projects (12)

ToolDescription
list_projectsList all projects
get_projectGet project details
create_projectCreate a new project
update_projectUpdate project details
delete_projectDelete a project
get_project_boardGet full kanban board (columns + tasks)
list_project_membersList project members
add_project_memberAdd a member to a project
remove_project_memberRemove a member from a project
get_project_time_statsGet project time statistics
get_gantt_dataGet Gantt chart data with dependencies
create_columnCreate a kanban column

Tasks (16)

ToolDescription
get_taskGet task details (assignees, subtasks, tags)
create_taskCreate a task in a project column
update_taskUpdate task properties
delete_taskDelete a task
move_taskMove task to a different column
assign_taskAdd an assignee to a task
remove_assigneeRemove an assignee from a task
list_task_commentsList comments on a task
create_commentAdd a comment to a task
create_subtaskCreate a subtask (checklist item)
toggle_task_doneToggle task completion
add_tag_to_taskAdd a tag to a task
remove_tag_from_taskRemove a tag from a task
archive_taskArchive a task
restore_taskRestore an archived task
move_task_to_projectMove task to a different project

Time Tracking (8)

ToolDescription
list_time_entriesList time entries (filter by date, project)
create_time_entryLog a completed time entry
update_time_entryUpdate a time entry
delete_time_entryDelete a time entry
start_timerStart a running timer
stop_timerStop a running timer
get_running_timerGet the currently running timer
get_time_statsGet time tracking statistics

Calendar (5)

ToolDescription
list_eventsList calendar events in a date range
get_eventGet event details
create_eventCreate a calendar event
update_eventUpdate an event
delete_eventDelete an event

Invoices (14)

ToolDescription
list_invoicesList invoices (filter by status, client, type)
get_invoiceGet invoice with line items and totals
create_invoiceCreate a draft invoice
update_invoiceUpdate a draft invoice
delete_invoiceDelete a draft invoice
update_invoice_statusChange invoice status
send_invoice_emailSend invoice via email
create_invoice_from_timeCreate invoice from tracked time
add_invoice_line_itemAdd a line item
update_invoice_line_itemUpdate a line item
delete_invoice_line_itemDelete a line item
record_paymentRecord a payment on an invoice
create_credit_noteCreate a credit note (Gutschrift)
create_cancellationCreate a cancellation invoice (Stornorechnung)

Quotes (12)

ToolDescription
list_quotesList quotes/proposals
get_quoteGet quote with line items
create_quoteCreate a draft quote
update_quoteUpdate a quote
delete_quoteDelete a quote
update_quote_statusUpdate quote status
send_quote_emailSend quote via email
duplicate_quoteDuplicate a quote
convert_quote_to_invoiceConvert accepted quote to invoice
add_quote_line_itemAdd a line item
update_quote_line_itemUpdate a line item
delete_quote_line_itemDelete a line item

Recurring Invoices (8)

ToolDescription
list_recurring_invoicesList recurring invoice templates
get_recurring_invoiceGet recurring invoice details
create_recurring_invoiceCreate a recurring invoice
update_recurring_invoiceUpdate a recurring invoice
delete_recurring_invoiceDelete a recurring invoice
pause_recurring_invoicePause auto-generation
resume_recurring_invoiceResume auto-generation
generate_recurring_invoice_nowGenerate an invoice now

Payment Reminders (6)

ToolDescription
list_remindersList payment reminders (Mahnungen)
get_reminderGet reminder details
get_reminder_suggestionGet suggested reminder for overdue invoice
create_reminderCreate a payment reminder
send_reminder_emailSend reminder via email
delete_reminderDelete a reminder

Finance (11)

ToolDescription
get_finance_overviewMonthly revenue vs expenses
get_vat_summaryUSt-Voranmeldung (KZ 81/86/66/83)
list_received_invoicesList incoming invoices
get_received_invoiceGet received invoice details
approve_received_invoiceApprove a received invoice
list_suppliersList all suppliers
get_supplierGet supplier details
create_supplierCreate a supplier
update_supplierUpdate supplier details
delete_supplierDelete a supplier
get_datev_exportPreview DATEV export data

Team Planning (5)

ToolDescription
list_absencesList team absences
create_absenceCreate an absence entry
update_absenceUpdate an absence
delete_absenceDelete an absence
get_vacation_statsGet vacation quota/usage stats

Pages (7)

ToolDescription
list_pagesList all pages
get_pageGet page with content
create_pageCreate a new page
update_pageUpdate page metadata
update_page_contentUpdate page content
delete_pageDelete a page and children
get_page_treeGet page tree hierarchy

Whiteboards (6)

ToolDescription
list_whiteboardsList all whiteboards
get_whiteboardGet whiteboard with content
create_whiteboardCreate a whiteboard
update_whiteboardUpdate whiteboard metadata
delete_whiteboardDelete a whiteboard
duplicate_whiteboardDuplicate a whiteboard

File Storage (12)

ToolDescription
list_filesList files in a folder
get_fileGet file details
delete_fileDelete a file
get_file_download_urlGet presigned download URL
list_foldersList folders
create_folderCreate a new folder
update_folderUpdate folder name/color
delete_folderDelete a folder and contents
get_folder_treeGet full folder hierarchy
create_share_linkCreate a WeTransfer-style share link
list_share_linksList active share links
revoke_share_linkRevoke a share link

Tags (4)

ToolDescription
list_tagsList all tags
create_tagCreate a tag
update_tagUpdate a tag
delete_tagDelete a tag

Areas (4)

ToolDescription
list_areasList project areas/groups
create_areaCreate a project area
update_areaUpdate an area
delete_areaDelete an area

Notifications (4)

ToolDescription
list_notificationsList recent notifications
get_unread_countGet unread notification count
mark_notification_readMark a notification as read
mark_all_notifications_readMark all as read

Organization (8)

ToolDescription
get_organizationGet organization details
update_organizationUpdate organization settings
list_membersList team members
invite_memberInvite a new member via email
update_member_roleChange a member's role
remove_memberRemove a member
global_searchSearch across all entities
get_activity_feedGet recent activity feed

Development

bash
# Clone the repogit clone https://github.com/dversum/dversum.gitcd dversum/mcp-server
# Install dependenciesnpm install
# Buildnpm run build
# Run locallyDVERSUM_API_URL=http://localhost:8080/api/v1 \DVERSUM_API_TOKEN=your-jwt-token \node dist/bin/dversum-mcp.js

License

MIT

来源：README.md，提交 48e0a39

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v2.0.0最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。