Civitai MCP Server

Instructions

Implementation Reference

• src/index.ts:668-682 (handler)

  The primary handler function for the 'get_download_url' MCP tool. It extracts the modelVersionId from arguments, retrieves the download URL via the CivitaiClient, and returns a formatted text response with the URL and download instructions.

  private async getDownloadUrl(args: any) {
    const { modelVersionId } = args;
    const downloadUrl = this.client.getDownloadUrl(modelVersionId);
    
    return {
      content: [
        {
          type: 'text',
          text: `Download URL for model version ${modelVersionId}:\\n\\n${downloadUrl}\\n\\n` +
            `**Note:** Use \`wget "${downloadUrl}" --content-disposition\` to download with proper filename.\\n` +
            `If the model requires authentication, add your API key: \`?token=YOUR_API_KEY\``,
        },
      ],
    };
  }

• src/index.ts:313-323 (registration)

  The tool registration entry in the getTools() method, defining the name 'get_download_url', description, and input schema (requiring modelVersionId as number).

  {
    name: 'get_download_url',
    description: 'Get the download URL for a specific model version',
    inputSchema: {
      type: 'object',
      properties: {
        modelVersionId: { type: 'number', description: 'The ID of the model version to get download URL for' },
      },
      required: ['modelVersionId'],
    },
  },

• src/index.ts:316-322 (schema)

  The input schema for the get_download_url tool, specifying an object with required 'modelVersionId' property of type number.

  inputSchema: {
    type: 'object',
    properties: {
      modelVersionId: { type: 'number', description: 'The ID of the model version to get download URL for' },
    },
    required: ['modelVersionId'],
  },

• src/civitai-client.ts:155-157 (helper)

  Supporting helper method in CivitaiClient that generates the actual download URL by calling buildUrl with the model version endpoint.

  getDownloadUrl(modelVersionId: number): string {
    return this.buildUrl(`/download/models/${modelVersionId}`);
  }