eve-online-mcp

Instructions

Implementation Reference

• src/index.ts:391-413 (handler)

  Handler function that constructs the ESI endpoint for structure market orders, fetches the orders using makeESIRequest, formats them by mapping to a subset of fields, and returns as JSON text content.

  async ({ structure_id, page }) => {
    const endpoint = `/markets/structures/${structure_id}/${page ? `?page=${page}` : ''}`;
    const orders = await makeESIRequest<MarketOrder[]>(endpoint);
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(orders.map(order => ({
            order_id: order.order_id,
            type_id: order.type_id,
            price: order.price,
            volume_remain: order.volume_remain,
            volume_total: order.volume_total,
            is_buy_order: order.is_buy_order,
            duration: order.duration,
            issued: order.issued,
            range: order.range
          })), null, 2)
        }
      ]
    };
  }

• src/index.ts:387-390 (schema)

  Zod input schema defining parameters for the tool: structure_id (required number) and page (optional number).

  {
    structure_id: z.number().describe("Structure ID to get market orders from"),
    page: z.number().optional().describe("Which page to query, starts at 1"),
  },

• src/index.ts:384-414 (registration)

  Registration of the 'get-structure-orders' tool with McpServer using server.tool method, specifying name, description, input schema, and handler function.

  server.tool(
    "get-structure-orders",
    "Get all market orders in a structure",
    {
      structure_id: z.number().describe("Structure ID to get market orders from"),
      page: z.number().optional().describe("Which page to query, starts at 1"),
    },
    async ({ structure_id, page }) => {
      const endpoint = `/markets/structures/${structure_id}/${page ? `?page=${page}` : ''}`;
      const orders = await makeESIRequest<MarketOrder[]>(endpoint);
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(orders.map(order => ({
              order_id: order.order_id,
              type_id: order.type_id,
              price: order.price,
              volume_remain: order.volume_remain,
              volume_total: order.volume_total,
              is_buy_order: order.is_buy_order,
              duration: order.duration,
              issued: order.issued,
              range: order.range
            })), null, 2)
          }
        ]
      };
    }
  );

• src/index.ts:29-42 (schema)

  TypeScript interface defining the structure of MarketOrder objects returned by the ESI API, used in the handler's type annotation.

  interface MarketOrder {
    duration: number;
    is_buy_order: boolean;
    issued: string;
    location_id: number;
    min_volume: number;
    order_id: number;
    price: number;
    range: string;
    system_id: number;
    type_id: number;
    volume_remain: number;
    volume_total: number;
  }

• src/index.ts:222-256 (helper)

  Helper function for making authenticated ESI API requests, handling rate limits, errors, and headers; used by the tool handler to fetch orders.

  async function makeESIRequest<T>(endpoint: string, token?: string): Promise<T> {
    if (!checkRateLimit(endpoint)) {
      throw new Error("Rate limit exceeded. Please try again later.");
    }
  
    const headers: Record<string, string> = {
      "User-Agent": USER_AGENT,
      "Accept": "application/json",
    };
  
    if (token) {
      headers["Authorization"] = `Bearer ${token}`;
    }
  
    const response = await fetch(`${ESI_BASE_URL}${endpoint}`, { headers });
    updateRateLimit(endpoint, response.headers);
  
    if (!response.ok) {
      let errorMessage = `HTTP error! status: ${response.status}`;
      try {
        const errorData = await response.json() as ESIError;
        if (errorData.error) {
          errorMessage = `ESI Error: ${errorData.error}`;
          if (errorData.error_description) {
            errorMessage += ` - ${errorData.error_description}`;
          }
        }
      } catch {
        // エラーJSONのパースに失敗した場合は、デフォルトのエラーメッセージを使用
      }
      throw new Error(errorMessage);
    }
  
    return response.json() as Promise<T>;
  }