den MCP

den mcp

Den-MCP是多代理软件项目的共享控制平面。它提供了一个集中式的MCP/REST服务器、CLI/仪表板、Den web/操作员工作流支持，以及用于任务、消息、审查循环、代理流可观察性、项目文档和桌面/操作员客户端的API。

此存储库的任务在Den中的项目ID下跟踪 den-mcp.

它提供了什么

• 任务管理 --分层任务、依赖关系、优先级/状态工作流、审计历史和智能下一个任务选择。
• 任务线程消息 --具有每个代理读取状态的持久项目/任务/线程通信。
• 审查工作流程 --审查轮次、结构化调查结果、判决、合并交接和后续拆分。
• 代理流/运行记录 --编排器、子代理、漂移检查、验证和有针对性的微调的操作可见性。
• 文档存储 --Markdown文档（PRD、规格、ADR、约定、参考），带SQLite FTS5搜索。
• 共享黑板 --跨项目抓取/切换Markdown条目，可选空闲TTL。
• MCP+REST API --用于代理的MCP工具和用于CLI/web/桌面客户端的REST端点。
• CLI+TUI仪表板 --终端命令和终端。Gui仪表板。
• 桌面/操作员API --独立设备消耗的REST/MCP表面 den-desktop 应用程序。

仓库的规划

src/DenMcp.Core/                  Models, SQLite repositories, domain services
src/DenMcp.Server/                ASP.NET Core MCP + REST server
src/DenMcp.Cli/                   CLI commands + Terminal.Gui dashboard

tests/DenMcp.Core.Tests/          Core integration tests
tests/DenMcp.Server.Tests/        Server/API tests
tests/Architecture.Tests/         Dependency boundary tests

快速开始

dotnet build den-mcp.slnx
dotnet test den-mcp.slnx

运行服务器：

dotnet run --project src/DenMcp.Server

默认服务器URL: http://localhost:5199 默认数据库： ~/.den-mcp/den.db

覆盖默认值：

dotnet run --project src/DenMcp.Server -- --port 5200
dotnet run --project src/DenMcp.Server -- --db-path /tmp/den-mcp/dev.db

命令行界面

# Alias for convenience
alias den='dotnet run --project /path/to/den-mcp/src/DenMcp.Cli --'

den projects
den tasks --project den-mcp
den task 1154 --project den-mcp
den next --project den-mcp
den create-task --title "Build X" --project den-mcp
den status 1154 done --project den-mcp
den messages --project den-mcp
den send --content "Ready for review" --project den-mcp
den docs --project den-mcp
den doc project-bootstrap-guide --project den-mcp
den search "bridge submodule"
den blackboard list
den dashboard

这 --project 当省略时，标志会自动从当前目录名中检测。

仪表板

den dashboard

仪表板通过键盘驱动的导航显示项目、任务、文档和消息。分派是遗留/调试工件，而不是正常的工作队列。使用 den dashboard --legacy-dispatches 仅当明确检查遗留调度行时。

Den桌面

Den Desktop已移至独立版 den-desktop 存储库。不要将桌面UI、sidecar运行时、Electron打包或仅限桌面的夹具添加回此仓库。Den MCP保留了桌面客户端使用的服务器端REST/MCP API表面。

验证命令

一般验证：

dotnet build den-mcp.slnx
dotnet test den-mcp.slnx

桌面UI/sidecar和桥验证现在在独立的 den-desktop 存储库。

架构和边界规则

• DenMcp.Core 不依赖于ASP。NET，终端。例如Gui或桌面UI包。
• DenMcp.Server 引用Core并托管MCP+REST端点。
• DenMcp.Cli 通过API/CLI层进行通信，并且不会成为服务器基础设施。
• 桌面UI和sidecar代码独立存在 den-desktop 知识库；保持此仓库专注于Den核心/服务器/CLI表面。
• SQL必须参数化；不要插入SQL字符串。
• 使用明确的DI注册；不要添加自动扫描。
• Den API使用snake_case JSON。桥接协议DTO可能有意使用其协议契约命名。

MCP使用

MCP端点：

http://localhost:5199/mcp

MCP配置示例：

{
  "mcpServers": {
    "den": {
      "type": "http",
      "url": "http://localhost:5199/mcp"
    }
  }
}

对于手动启动的代理，更喜欢用户/全局MCP配置，而不是临时项目 .mcp.json 文件，这样本地配置就不会影响工作的全局端点。

部署

systemd服务文件提供于 deploy/den-mcp.service.

dotnet publish src/DenMcp.Server -c Release -o /opt/den-mcp
sudo cp deploy/den-mcp.service /etc/systemd/system/
sudo systemctl enable --now den-mcp

Signal/Telegram移动网桥集成和传统的小猫助手已经退役。当前操作员工作流使用Den web、Den Desktop、Pi/编排器运行、任务线程消息、审核记录、代理流操作和AgentRun状态。

许可证

麻省理工学院