Dida365 MCP Server

Instructions

Implementation Reference

• src/dida_mcp/client.py:70-88 (handler)

  The actual implementation of the 'create_project' tool which performs the HTTP POST request to the Dida365 Open API.

  def create_project(
      self,
      name: str,
      color: Optional[str] = None,
      view_mode: Optional[str] = None,
      folder_id: Optional[str] = None,
  ) -> Dict:
      """创建新项目（清单）"""
      data: Dict[str, Any] = {"name": name}
      if color:
          data["color"] = color
      if view_mode:
          data["viewMode"] = view_mode
      if folder_id:
          data["folderId"] = folder_id
  
      response = self.client.post("/project", json=data)
      response.raise_for_status()
      return response.json()

• src/dida_mcp/server.py:110-123 (registration)

  Tool definition schema for 'create_project'.

      "name": "create_project",
      "description": "创建新的项目（清单）。",
      "inputSchema": {
          "type": "object",
          "properties": {
              "name": {"type": "string", "description": "项目名称"},
              "color": {
                  "type": "string",
                  "description": "项目颜色（可选，如 '#FF6347'）",
              },
          },
          "required": ["name"],
      },
  },

• src/dida_mcp/server.py:325-330 (handler)

  Dispatch logic for 'create_project' which calls the client implementation.

  elif name == "create_project":
      project = client.create_project(
          name=args["name"],
          color=args.get("color"),
      )
      return "✅ 项目创建成功！\n\n%s" % format_project(project)