mcp-github-project-manager

Instructions

Implementation Reference

• src/services/ProjectManagementService.ts:1150-1162 (handler)

  The core handler function that fetches and returns the custom fields for a given GitHub project ID by querying the project repository.

  async listProjectFields(data: {
    projectId: string;
  }): Promise<CustomField[]> {
    try {
      const project = await this.projectRepo.findById(data.projectId);
      if (!project) {
        throw new ResourceNotFoundError(ResourceType.PROJECT, data.projectId);
      }
      return project.fields || [];
    } catch (error) {
      throw this.mapErrorToMCPError(error);
    }
  }

• src/infrastructure/tools/ToolSchemas.ts:1528-1541 (schema)

  Tool definition including input schema (requires projectId), description, and example usage.

  export const listProjectFieldsTool: ToolDefinition<ListProjectFieldsArgs> = {
    name: "list_project_fields",
    description: "List all fields in a GitHub project",
    schema: listProjectFieldsSchema as unknown as ToolSchema<ListProjectFieldsArgs>,
    examples: [
      {
        name: "List project fields",
        description: "Get all fields for a specific project",
        args: {
          projectId: "PVT_kwDOLhQ7gc4AOEbH"
        }
      }
    ]
  };

• src/infrastructure/tools/ToolRegistry.ts:243-243 (registration)

  Registers the listProjectFieldsTool in the central tool registry during initialization.

  this.registerTool(listProjectFieldsTool);

• src/index.ts:280-281 (handler)

  MCP server dispatcher that routes tool calls to the ProjectManagementService handler.

  case "list_project_fields":
    return await this.service.listProjectFields(args);