Phrases MCP Server

Instructions

Implementation Reference

• src/index.ts:157-181 (registration)

  Registration of the 'delete-phrase' MCP tool, including description, input schema, and execution handler.

  server.tool(
      "delete-phrase",
      "Deletes a phrase by its ID.",
      {
          id: z.number().min(0).describe("Phrase ID to delete")
      },
      async ({id}) => {
          const result = await makeMockAPIRequest<null>("DELETE", {
              path: `/${id}`,
          });
  
          const resultText = result === null
              ? `Phrase with ID ${id} was successfully deleted.`
              : `Failed to delete phrase with ID ${id}.`;
  
          return {
              content: [
                  {
                      type: "text",
                      text: resultText
                  }
              ]
          }
      }
  );

• src/index.ts:163-180 (handler)

  Handler function that executes the delete-phrase tool: calls mock API DELETE, formats success/failure message.

  async ({id}) => {
      const result = await makeMockAPIRequest<null>("DELETE", {
          path: `/${id}`,
      });
  
      const resultText = result === null
          ? `Phrase with ID ${id} was successfully deleted.`
          : `Failed to delete phrase with ID ${id}.`;
  
      return {
          content: [
              {
                  type: "text",
                  text: resultText
              }
          ]
      }
  }

• src/index.ts:160-162 (schema)

  Zod input schema for the tool requiring a positive integer Phrase ID.

  {
      id: z.number().min(0).describe("Phrase ID to delete")
  },

• src/helpers/makeMockAPIRequest.ts:28-62 (helper)

  Shared helper function that performs the actual HTTP DELETE request to the mock API, used by the delete-phrase handler.

  export async function makeMockAPIRequest<T>(
      method: HTTPMethod,
      options: RequestOptions = {}
  ): Promise<T | null> {
      const { path, queryParams, body } = options;
      let url = BASE_URL;
  
      if (path) url += path;
      if (method === "GET" && queryParams) {
          const query = new URLSearchParams(queryParams).toString();
          url += `?${query}`;
      }
  
      const headers: HeadersInit = {
          "Content-Type": "application/json",
      };
  
      const fetchOptions: RequestInit = {
          method,
          headers,
          body: body && method !== "GET" && method !== "DELETE"
              ? JSON.stringify(body)
              : undefined,
      };
  
      try {
          const response = await fetch(url, fetchOptions);
          if (!response.ok) throw new Error(`HTTP error: ${response.status}`);
          if (method === "DELETE" || response.status === 204) return null;
          return await response.json();
      } catch (err) {
          console.error(`Error on ${method} ${url}:`, err);
          return null;
      }
  }

• src/helpers/makeMockAPIRequest.ts:18-18 (schema)

  TypeScript type definition for DeletePhraseParams.

  export type DeletePhraseParams = { id: number };