{"id":27639854,"url":"https://github.com/waldekmastykarz/dev-proxy-mcp","last_synced_at":"2025-04-23T22:34:53.591Z","repository":{"id":289430647,"uuid":"970899175","full_name":"waldekmastykarz/dev-proxy-mcp","owner":"waldekmastykarz","description":"Dev Proxy MCP server","archived":false,"fork":false,"pushed_at":"2025-04-23T08:12:50.000Z","size":16,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-23T08:46:20.276Z","etag":null,"topics":["dev-proxy","mcp","mock-server","model-context-protocol","model-context-protocol-servers"],"latest_commit_sha":null,"homepage":"https://aka.ms/devproxy","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waldekmastykarz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-04-22T17:49:06.000Z","updated_at":"2025-04-23T08:11:56.000Z","dependencies_parsed_at":"2025-04-23T08:46:23.376Z","dependency_job_id":null,"html_url":"https://github.com/waldekmastykarz/dev-proxy-mcp","commit_stats":null,"previous_names":["waldekmastykarz/dev-proxy-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldekmastykarz%2Fdev-proxy-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldekmastykarz%2Fdev-proxy-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldekmastykarz%2Fdev-proxy-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waldekmastykarz%2Fdev-proxy-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waldekmastykarz","download_url":"https://codeload.github.com/waldekmastykarz/dev-proxy-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250430595,"owners_count":21429323,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dev-proxy","mcp","mock-server","model-context-protocol","model-context-protocol-servers"],"created_at":"2025-04-23T22:34:53.149Z","updated_at":"2025-04-23T22:34:53.581Z","avatar_url":"https://github.com/waldekmastykarz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Dev Proxy MCP Server\n\n[![Install with NPX in VS Code](https://img.shields.io/badge/VS_Code-Install_Dev_Proxy_MCP_Server-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Dev%20Proxy\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40devproxy%2Fmcp%40latest%22%5D%7D) [![Install with NPX in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install_Dev_Proxy_MCP_Server-24bfa5?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=Dev%20Proxy\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40devproxy%2Fmcp%40latest%22%5D%7D\u0026quality=insiders)\n\nA Model Context Protocol (MCP) server for [Dev Proxy](https://aka.ms/devproxy) that enables AI assistants to interact with Dev Proxy capabilities using the MCP standard. Use this server to:\n\n1. Create Dev Proxy configurations using natural language\n1. Get contextual help for working with Dev Proxy\n1. Discover Dev Proxy features and capabilities\n\n![Screenshot of Visual Studio Code with GitHub Copilot chat pane open. GitHub Copilot works in assistant mode and uses the Dev Proxy MCP server to retrieve relevant information and create Dev Proxy configuration that matches the specified prompt.](assets/image.png)\n\n## What is Dev Proxy?\n\nDev Proxy is an API simulator that helps you effortlessly test your app beyond the happy path. It allows you to:\n\n- **Test API error handling**: See how your app responds to API errors without changing your code\n- **Verify rate limit handling**: Simulate API rate limits to improve user experience\n- **Test slow API responses**: See how your app handles slow APIs to implement necessary affordances\n- **Create mock APIs**: Quickly stand up mock APIs without writing code you won't ship\n\nDev Proxy works with any type of app and tech stack as it intercepts network requests at the proxy level.\n\n## What This Package Does\n\nThis package provides a Model Context Protocol (MCP) server interface to Dev Proxy. It allows AI assistants and other MCP-compatible clients to:\n\n1. **Find Dev Proxy documentation** using natural language queries\n2. **Get the installed Dev Proxy version**\n\n## Prerequisites\n\n- [Node.js](https://nodejs.org/) LTS\n- [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/get-started/set-up) installed globally\n\n## Usage\n\nTo set up and use the MCP server, refer to the instructions for your MCP host, such as [Visual Studio Code](https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server). The Dev Proxy MCP server is published on npm under [`@devproxy/mcp`](https://www.npmjs.com/package/@devproxy/mcp).\n\nUse the following values:\n\n- **Type**: `stdio`\n- **Command**: `npx`\n- **Arguments**:\n  - `-y`\n  - `@devproxy/mcp`\n- **Environment**: _none_\n\n\u003e [!TIP]\n\u003e If you want to test the preview version of the server using `@devproxy/mcp@next`.\n\n### Connect with an MCP Client\n\nThis MCP server exposes the following tools:\n\n#### FindDocs\n\nFinds relevant Dev Proxy documentation related to a specific query.\n\n```json\n{\n  \"query\": \"How to simulate API errors\"\n}\n```\n\n#### GetVersion\n\nGets the currently installed Dev Proxy version. This is useful to ensure that the generated configuration is compatible with the installed version of Dev Proxy.\n\n```json\n{}\n```\n\n## Development\n\n```bash\n# Clone the repository\ngit clone https://github.com/waldekmastykarz/dev-proxy-mcp.git\ncd dev-proxy-mcp\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n\n# Run the server\nnpm start\n\n# Run with MCP inspector for debugging\nnpm run inspect\n```\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Related Projects\n\n- [Dev Proxy](https://learn.microsoft.com/microsoft-cloud/dev/dev-proxy/overview) - The core Dev Proxy tool\n- [Model Context Protocol (MCP)](https://modelcontextprotocol.io) - Protocol specification for AI assistant tools\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaldekmastykarz%2Fdev-proxy-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaldekmastykarz%2Fdev-proxy-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaldekmastykarz%2Fdev-proxy-mcp/lists"}