Fountain Pen Ink MCP Server

Instructions

Implementation Reference

• src/index.ts:403-429 (handler)

  The primary handler function implementing the get_ink_details tool logic. It looks up the ink by ID in the loaded inkColors and metadata arrays, generates a detailed result using createSearchResult, computes hex color, family, and description, and returns a formatted MCPTextResponse.

  private getInkDetails(inkId: string): MCPTextResponse {
    const inkColor = this.inkColors.find((ink) => ink.ink_id === inkId);
    const metadata = this.getInkMetadata(inkId);
  
    if (!inkColor) {
      throw new Error(`Ink not found: ${inkId}`);
    }
  
    const result = createSearchResult(inkColor, metadata);
  
    return {
      content: [
        {
          type: 'text',
          text: JSON.stringify(
            {
              ink_details: result,
              hex_color: rgbToHex(inkColor.rgb), // Now actually RGB!
              color_family: getColorFamily(inkColor.rgb),
              color_description: getColorDescription(inkColor.rgb),
            },
            null,
            2,
          ),
        },
      ],
    } satisfies MCPTextResponse;

• src/index.ts:178-191 (registration)

  Tool registration entry in the ListToolsRequestSchema handler, defining the tool name, description, and input schema for get_ink_details.

  {
    name: 'get_ink_details',
    description: 'Get complete information about a specific ink',
    inputSchema: {
      type: 'object',
      properties: {
        ink_id: {
          type: 'string',
          description: 'The unique identifier for the ink',
        },
      },
      required: ['ink_id'],
    },
  },

• src/index.ts:181-190 (schema)

  Input schema definition for the get_ink_details tool, specifying the required 'ink_id' string parameter.

  inputSchema: {
    type: 'object',
    properties: {
      ink_id: {
        type: 'string',
        description: 'The unique identifier for the ink',
      },
    },
    required: ['ink_id'],
  },

• src/index.ts:283-284 (handler)

  Dispatch handler in the CallToolRequestSchema switch statement that routes calls to get_ink_details to the private getInkDetails method.

  case 'get_ink_details':
    return this.getInkDetails(args.ink_id as string);

• src/index.ts:127-129 (helper)

  Helper method used by getInkDetails to retrieve search metadata for the ink by ID.

  private getInkMetadata(inkId: string): InkSearchData | undefined {
    return this.inkSearchData.find((item) => item.ink_id === inkId);
  }