Yuque MCP Server

Instructions

Implementation Reference

• src/server.ts:456-489 (handler)

  Full tool registration block for 'delete_doc' including inline handler function that performs the deletion logic by calling yuqueService.deleteDoc()

  this.server.tool(
    "delete_doc",
    "从语雀知识库中删除指定文档，此操作不可撤销",
    {
      namespace: z.string().describe("知识库的命名空间，格式为 user/repo"),
      id: z.number().describe("要删除的文档ID"),
      accessToken: z.string().optional().describe("用于认证 API 请求的令牌"),
    },
    async ({ namespace, id, accessToken }) => {
      try {
        Logger.log(`Deleting document ${id} from repository: ${namespace}`);
        const yuqueService = this.createYuqueService(accessToken);
        await yuqueService.deleteDoc(namespace, id);
  
        Logger.log(`Successfully deleted document ${id}`);
        return {
          content: [
            {
              type: "text",
              text: `Document ${id} has been successfully deleted`,
            },
          ],
        };
      } catch (error) {
        Logger.error(
          `Error deleting doc ${id} from repo ${namespace}:`,
          error
        );
        return {
          content: [{ type: "text", text: `Error deleting doc: ${error}` }],
        };
      }
    }
  );

• src/server.ts:459-463 (schema)

  Zod input schema definition for the delete_doc tool parameters

  {
    namespace: z.string().describe("知识库的命名空间，格式为 user/repo"),
    id: z.number().describe("要删除的文档ID"),
    accessToken: z.string().optional().describe("用于认证 API 请求的令牌"),
  },

• src/services/yuque.ts:382-385 (helper)

  YuqueService helper method that executes the actual Yuque API DELETE request to remove the document.

  async deleteDoc(namespace: string, id: number): Promise<YuqueDoc> {
    const response = await this.client.delete(`/repos/${namespace}/docs/${id}`);
    return response.data.data;
  }