Harvest MCP Server

Instructions

Implementation Reference

• src/index.ts:176-185 (handler)

  MCP server handler dispatches to HarvestClient.getProjects with tool arguments and formats response as JSON text content.
  case 'harvest_list_projects': const projects = await harvestClient.getProjects(typedArgs); return { content: [ { type: 'text', text: JSON.stringify(projects, null, 2), }, ], };
• src/tools.ts:105-116 (schema)

  Tool definition with name, description, and input schema for MCP registration and validation.
  name: 'harvest_list_projects', description: 'List all projects with filtering options. Use about {"tool": "harvest_list_projects"} for detailed parameters and examples.', inputSchema: { type: 'object', properties: { is_active: { type: 'boolean', description: 'Filter by active status' }, client_id: { type: 'string', description: 'Filter by client ID' }, page: { type: 'number', description: 'Page number' }, per_page: { type: 'number', description: 'Results per page (max 100)' } } } },
• src/harvest-client.ts:117-120 (helper)

  Core implementation fetches projects from Harvest API endpoint /projects with built query parameters.
  async getProjects(options?: any) { const queryString = this.buildQueryString(options); return this.makeRequest(`/projects${queryString}`); }
• src/index.ts:69-73 (registration)

  Registers all tools (including harvest_list_projects) for MCP listTools request handling.
  server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: tools, }; });
• src/harvest-client.ts:59-72 (helper)

  Utility method builds query string from filter parameters used by getProjects.
  private buildQueryString(params?: Record<string, any>): string { if (!params) return ''; const queryParams = new URLSearchParams(); Object.entries(params).forEach(([key, value]) => { if (value !== undefined && value !== null) { queryParams.append(key, String(value)); } }); const queryString = queryParams.toString(); return queryString ? `?${queryString}` : ''; }