io.github.dev-proxy-tools/mcp

Dev Proxy MCP Server

A Model Context Protocol (MCP) server for Dev Proxy that enables AI assistants to interact with Dev Proxy capabilities using the MCP standard. Use this server to:

1. Create Dev Proxy configurations using natural language
2. Get contextual help for working with Dev Proxy
3. Discover Dev Proxy features and capabilities

What is Dev Proxy?

Dev Proxy is an API simulator that helps you effortlessly test your app beyond the happy path. It allows you to:

• Test API error handling: See how your app responds to API errors without changing your code
• Verify rate limit handling: Simulate API rate limits to improve user experience
• Test slow API responses: See how your app handles slow APIs to implement necessary affordances
• Create mock APIs: Quickly stand up mock APIs without writing code you won't ship

Dev Proxy works with any type of app and tech stack as it intercepts network requests at the proxy level.

What This Package Does

This package provides a Model Context Protocol (MCP) server interface to Dev Proxy. It allows AI assistants and other MCP-compatible clients to:

1. Find Dev Proxy documentation using natural language queries
2. Get the installed Dev Proxy version

Prerequisites

• Node.js LTS
• Dev Proxy installed globally

Usage

To set up and use the MCP server, refer to the instructions for your MCP host, such as Visual Studio Code. The Dev Proxy MCP server is published on npm under @devproxy/mcp.

Use the following values:

• Type: stdio
• Command: npx
• Arguments:
  • -y
  • @devproxy/mcp
• Environment: none

[!TIP] If you want to test the preview version of the server using @devproxy/mcp@next.

Connect with an MCP Client

This MCP server exposes the following tools:

GetBestPractices

Gets a list of best practices for configuring and using Dev Proxy. Call it for any code generation or operation involving Dev Proxy. These best practices do not change so once it has been called during the current session, you do not need to invoke it again.

_Best practices in markdown_

FindDocs

Finds relevant Dev Proxy documentation related to a specific query.

{
  "query": "How to simulate API errors"
}

GetVersion

Gets the currently installed Dev Proxy version. This is useful to ensure that the generated configuration is compatible with the installed version of Dev Proxy.

{}

Development

# Clone the repository
git clone https://github.com/waldekmastykarz/dev-proxy-mcp.git
cd dev-proxy-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm start

# Run with MCP inspector for debugging
npm run inspect

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related Projects

• Dev Proxy - The core Dev Proxy tool
• Model Context Protocol (MCP) - Protocol specification for AI assistant tools