discogs-mcp-server 0.2.0 → 0.4.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Christopher Kim
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,9 @@
+[![License](https://img.shields.io/github/license/cswkim/discogs-mcp-server)](LICENSE)
+[![GitHub Release](https://img.shields.io/github/v/release/cswkim/discogs-mcp-server)](https://github.com/cswkim/discogs-mcp-server/releases)
+[![GitHub Actions Workflow Status](https://img.shields.io/github/actions/workflow/status/cswkim/discogs-mcp-server/.github%2Fworkflows%2Fcheck-pr.yml)](https://github.com/cswkim/discogs-mcp-server/actions/workflows/check-pr.yml)
+[![NPM Downloads](https://img.shields.io/npm/d18m/discogs-mcp-server)](https://www.npmjs.com/package/discogs-mcp-server)
+[![Sponsor](https://img.shields.io/static/v1?label=sponsor&message=%E2%9D%A4&logo=GitHub&color=ff69b4)](https://github.com/sponsors/cswkim)
+
 # Discogs MCP Server
 
 MCP Server for the Discogs API, enabling music catalog operations, search functionality, and more.
@@ -68,7 +74,7 @@ The other environment variables in `.env.example` are optional and have sensible
 
 2. Available commands:
    - `pnpm run dev`: Start the development server with hot reloading
-   - `pnpm run dev:sse`: Start the development server with hot reloading in SSE mode
+   - `pnpm run dev:stream`: Start the development server with hot reloading in HTTP streaming mode
    - `pnpm run build`: Build the production version
    - `pnpm run start`: Run the production build
    - `pnpm run inspect`: Run the MCP Inspector (see [Inspection](#inspection) section)
@@ -90,10 +96,10 @@ The other environment variables in `.env.example` are optional and have sensible
    docker run --env-file .env discogs-mcp-server:latest
    ```
 
-   For SSE transport mode:
+   For HTTP Streaming transport mode:
    ```bash
    # The port should match what is in your .env file
-   docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest sse
+   docker run --env-file .env -p 3001:3001 discogs-mcp-server:latest stream
    ```
 
 ## Inspection
@@ -187,7 +193,6 @@ Any changes to local code will require Claude to be restarted to take effect. Al
 - OAuth support
 - Missing tools:
   - Inventory uploading
-  - Editing collection custom fields
 
 ## License
 

package/dist/index.js

@@ -4,7 +4,7 @@ import dotenv from 'dotenv';
 import { z } from 'zod';
 
 // src/version.ts
-var VERSION = "0.2.0";
+var VERSION = "0.4.0";
 
 // src/config.ts
 dotenv.config();
@@ -1757,6 +1757,14 @@ var UserCollectionCustomFieldsSchema = z.object({
     })
   )
 });
+var UserCollectionCustomFieldEditParamsSchema = UsernameInputSchema.merge(
+  FolderIdParamSchema().extend({
+    value: z.string(),
+    release_id: z.union([z.number(), z.string()]),
+    instance_id: z.union([z.number(), z.string()]),
+    field_id: z.number()
+  })
+);
 var UserCollectionFolderSchema = z.object({
   id: z.number(),
   count: z.number(),
@@ -2248,6 +2256,39 @@ var UserCollectionService = class extends BaseUserService {
       throw new Error(`Failed to delete release from folder: ${String(error)}`);
     }
   }
+  /**
+   * Edit a custom field value for a release in a user's collection
+   *
+   * @param params The parameters for the custom field value edit
+   * @throws {DiscogsAuthenticationError} If authentication fails
+   * @throws {DiscogsPermissionError} If trying to edit a custom field value of another user
+   * @throws {DiscogsResourceNotFoundError} If the username, folder_id, release_id, or instance_id cannot be found
+   * @throws {DiscogsValidationFailedError} If the field is a dropdown and the value is not in the list of options
+   * @throws {Error} If there's an unexpected error
+   */
+  async editCustomFieldValue({
+    username,
+    folder_id,
+    release_id,
+    instance_id,
+    field_id,
+    value
+  }) {
+    try {
+      await this.request(
+        `/${username}/collection/folders/${folder_id}/releases/${release_id}/instances/${instance_id}/fields/${field_id}`,
+        {
+          method: "POST",
+          body: { value }
+        }
+      );
+    } catch (error) {
+      if (isDiscogsError(error)) {
+        throw error;
+      }
+      throw new Error(`Failed to edit custom field value: ${String(error)}`);
+    }
+  }
   /**
    * Edit a folder's metadata. Folders 0 and 1 cannot be renamed.
    *
@@ -2756,6 +2797,20 @@ var deleteUserCollectionFolderTool = {
     }
   }
 };
+var editUserCollectionCustomFieldValueTool = {
+  name: "edit_user_collection_custom_field_value",
+  description: `Edit a custom field value for a release in a user's collection`,
+  parameters: UserCollectionCustomFieldEditParamsSchema,
+  execute: async (args) => {
+    try {
+      const userService = new UserService();
+      await userService.collection.editCustomFieldValue(args);
+      return "Custom field value edited successfully";
+    } catch (error) {
+      throw formatDiscogsError(error);
+    }
+  }
+};
 var editUserCollectionFolderTool = {
   name: "edit_user_collection_folder",
   description: `Edit a folder's metadata. Folders 0 and 1 cannot be renamed.`,
@@ -2895,6 +2950,7 @@ function registerUserCollectionTools(server) {
   server.addTool(moveReleaseInUserCollectionTool);
   server.addTool(deleteReleaseFromUserCollectionFolderTool);
   server.addTool(getUserCollectionCustomFieldsTool);
+  server.addTool(editUserCollectionCustomFieldValueTool);
   server.addTool(getUserCollectionValueTool);
 }
 var DiscogsUserIdentitySchema = z.object({
@@ -3257,13 +3313,15 @@ function registerTools(server) {
 
 // src/index.ts
 function assertTransportType(transportType) {
-  return transportType === "stdio" || transportType === "sse";
+  return transportType === "stdio" || transportType === "stream";
 }
 try {
   validateConfig();
   const transportType = process.argv[2] ?? "stdio";
   if (!assertTransportType(transportType)) {
-    throw Error(`Invalid transport type: "${transportType}". Allowed: 'stdio' (default) or 'sse'.`);
+    throw Error(
+      `Invalid transport type: "${transportType}". Allowed: 'stdio' (default) or 'stream'.`
+    );
   }
   const server = new FastMCP({
     name: config.server.name,
@@ -3272,11 +3330,10 @@ try {
   registerTools(server);
   if (transportType === "stdio") {
     server.start({ transportType });
-  } else if (transportType === "sse") {
+  } else if (transportType === "stream") {
     server.start({
-      transportType,
-      sse: {
-        endpoint: "/sse",
+      transportType: "httpStream",
+      httpStream: {
         port: config.server.port
       }
     });