npm @devproxy/mcpstdioMITupdated 15d ago
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:
What can you do with dev proxy tools?
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:
- Create Dev Proxy configurations using natural language
- Get contextual help for working with Dev Proxy
- 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:
- Find Dev Proxy documentation using natural language queries
- Get the installed Dev Proxy version
Prerequisites
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.
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - 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
Install
Add dev proxy tools to your client. Pick the one you use.
claude mcp add mcp -- npx -y @devproxy/mcpcodex mcp add mcp -- npx -y @devproxy/mcpamp mcp add mcp -- npx -y @devproxy/mcp{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@devproxy/mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@devproxy/mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"mcp","command":"npx","args":["-y","@devproxy/mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@devproxy/mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@devproxy/mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@devproxy/mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@devproxy/mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"@devproxy/mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @devproxy/mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation21/25
- Maintenance19/25
- Trust16/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 8 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.3.1Latest | Jan 6, 2026 |