{
  "markdown": "# mcp-performance\nA Gemini CLI extension and MCP server to analyze web page performance\n\n## Gemini CLI Extension\n\nThis project is intended to be installed as a Gemini CLI extension. This will include both the MCP server and commands for consistent AI responses. To install it, use the following command:\n\n```bash\ngemini extensions install https://github.com/mcclatchy/mcp-performance\n```\n\nAfter installing, you will have access to a performance MCP server as well as commands that we have created to assist you. Commands begin with the `/` character, such as `/performance-analysis`, and will be visible in the client. These commands will automatically pull performance data using the MCP server. If you would like to pull performance data for a different conversation, you can initiate the MCP tool directly in a prompt. This direct invocation pattern works consistently but is not strictly necessary when using the Gemini CLI commands:\n\n```\n`performance-entries` --url=\"https://www.coralspringsflnews.com\" --mark=\"flex first rendered\"\n```\n\n## MCP Server\n\nThis project can also be run as a standalone MCP server. This is useful for developers who want to use this tool with other MCP clients, such as [mcp-inspector](https://modelcontextprotocol.to/docs/tools/inspector), or other LLM clients like Claude. To run the server for these clients, use the following command:\n\n```\nnpx github:mcclatchy/mcp-performance\n```\n\nFor local development and testing with the Gemini CLI, please refer to the \"Local Development\" section and use `npm start`.\n\n*Note: you do not need to use the `npx` command if using Gemini CLI.*\n\n## Local Development\n\nFor developers working on the `mcp-performance` project, follow these steps:\n\n### Installation\n\nThis project requires Node.js and npm. To install the development dependencies, run the following command:\n\n```bash\nnpm install\n```\n\n### Running the MCP Server Locally\n\nTo run the MCP server for local development, use the following command:\n\n```bash\nnpm start\n```\n\nThis will start the MCP server and make it available for testing with the Gemini CLI or other MCP clients.\n\n### Using Performance Marks\n\nThe `performance-entries` tool can wait for a specific `performance.mark` to be set on the page before collecting performance metrics. This is particularly useful for measuring custom events or ensuring that a specific part of the application has loaded or executed.\n\nTo use this feature, provide the `mark` parameter with the name of the performance mark you wish to wait for. For example, if your webpage sets a mark like `performance.mark('myCustomEvent')`, you can instruct the tool to wait for it.\n\nExample (when used with Gemini CLI):\n\n```bash\ngemini performance-entries --url \"https://example.com\" --mark \"myCustomEvent\"\n```\n\n",
  "bytes": 2767,
  "sha": "efe096f6d29fd59f58e85604a09163647e0fe7682c7661bb7a29902ea520eda2",
  "repo_slug": "mcclatchy/mcp-performance",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_mcclatchy_mcp_performance_c2fe7810/readme"
}