# Dapr MCP Server

> Dapr MCP Server is an open-source MCP server for cloud and infrastructure. Expose Dapr state, pub/sub, secrets, locks and actors to AI agents as MCP tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, CLI, Linux, macOS, Windows
- **Website:** https://docs.dapr.io/developing-ai/mcp/dapr-mcp-server/
- **Repository:** https://github.com/dapr/dapr-mcp-server
- **MCP Registry name:** io.github.dapr/dapr-mcp-server
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-15

## About

Written in Go, this server runs beside a Dapr sidecar and turns the sidecar's building blocks into MCP tools. Because the agent talks to Dapr components rather than to a specific database or broker, swapping Redis for PostgreSQL or Kafka for RabbitMQ needs no change on the agent side. The docs mark the project as alpha.

Tools are registered from the components the sidecar has loaded. Three are always present: get_components, invoke_service and invoke_actor_method. If a deployment has no pub/sub broker, the pub/sub tools are not offered, and hot-reloaded components add or remove tools while clients are notified of the change. The server instructs the model to call get_components first and never invent component names, keys or topics.

It serves stdio for local clients or streamable HTTP with --http for shared deployments; authentication, health endpoints and CORS apply only to HTTP. Authentication can use OIDC, SPIFFE, Dapr Sentry or a hybrid. The docs warn that the server can do anything its sidecar can, including returning secret values to the model, so components and scopes should be limited.

## Features

- **Dynamic tool registration:** Tools follow the components loaded in the sidecar, with no restart.
- **Broad building-block coverage:** State, pub/sub, bindings, secrets, locks, cryptography, conversation, actors and service invocation.
- **Stdio and HTTP transports:** Run locally for IDE clients or over streamable HTTP for shared setups.
- **Pluggable authentication:** HTTP mode can be gated by OIDC, SPIFFE, Dapr Sentry or a hybrid.
- **Safety annotations:** Each tool carries readOnly, destructive and idempotent hints.
- **Observability:** Tool calls emit OpenTelemetry spans and metrics, with optional log export.

## Good for

- Let an agent read and write through a Dapr state store
- Publish events or call other Dapr apps from an agent
- Coordinate workers with a distributed lock
- Fetch secrets or encrypt data through Dapr components

## Install

### Claude Code (Terminal)

```sh
claude mcp add dapr-mcp-server --env DAPR_GRPC_PORT='<DAPR_GRPC_PORT>' --env DAPR_API_TOKEN='<DAPR_API_TOKEN>' -- docker run -i --rm -e DAPR_GRPC_PORT -e DAPR_API_TOKEN ghcr.io/dapr/dapr-mcp-server:v0.0.3
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "dapr-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DAPR_GRPC_PORT",
        "-e",
        "DAPR_API_TOKEN",
        "ghcr.io/dapr/dapr-mcp-server:v0.0.3"
      ],
      "env": {
        "DAPR_GRPC_PORT": "<DAPR_GRPC_PORT>",
        "DAPR_API_TOKEN": "<DAPR_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "dapr-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DAPR_GRPC_PORT",
        "-e",
        "DAPR_API_TOKEN",
        "ghcr.io/dapr/dapr-mcp-server:v0.0.3"
      ],
      "env": {
        "DAPR_GRPC_PORT": "<DAPR_GRPC_PORT>",
        "DAPR_API_TOKEN": "<DAPR_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "dapr-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DAPR_GRPC_PORT",
        "-e",
        "DAPR_API_TOKEN",
        "ghcr.io/dapr/dapr-mcp-server:v0.0.3"
      ],
      "env": {
        "DAPR_GRPC_PORT": "<DAPR_GRPC_PORT>",
        "DAPR_API_TOKEN": "<DAPR_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "dapr-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DAPR_GRPC_PORT",
        "-e",
        "DAPR_API_TOKEN",
        "ghcr.io/dapr/dapr-mcp-server:v0.0.3"
      ],
      "env": {
        "DAPR_GRPC_PORT": "<DAPR_GRPC_PORT>",
        "DAPR_API_TOKEN": "<DAPR_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "dapr-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DAPR_GRPC_PORT",
        "-e",
        "DAPR_API_TOKEN",
        "ghcr.io/dapr/dapr-mcp-server:v0.0.3"
      ],
      "env": {
        "DAPR_GRPC_PORT": "<DAPR_GRPC_PORT>",
        "DAPR_API_TOKEN": "<DAPR_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `get_components`: Lists the components loaded in the Dapr sidecar.
- `invoke_service`: Calls another Dapr app through service invocation.
- `invoke_actor_method`: Calls a method on a Dapr actor.
- `delete_state`: Deletes a key from a state store.
- `execute_transaction`: Runs a state transaction.
- `invoke_output_binding`: Calls an output binding.
- `encrypt_data`: Encrypts data with a Dapr crypto component.
- `get_secret`: Reads a secret.
- `get_bulk_secrets`: Reads several secrets.

## FAQ

### How do I run it?

Start it with dapr run next to a sidecar, or pull the container image ghcr.io/dapr/dapr-mcp-server; the container is meant for Kubernetes with sidecar injection.

### Which tools are always available?

get_components, invoke_service and invoke_actor_method.

### Which tools should need human confirmation?

The docs list delete_state, execute_transaction, invoke_service, invoke_actor_method, invoke_output_binding and encrypt_data as destructive.

### What does the sidecar connection use?

gRPC, with DAPR_GRPC_PORT defaulting to 50001; it retries five times and then exits.

### Is it production ready?

The documentation labels it alpha.

### Is Dapr MCP Server free?

Yes. Dapr MCP Server is open source, so you can use and self-host it for free.

### How do I add Dapr MCP Server to Claude Code?

Run this command in your terminal: claude mcp add dapr-mcp-server --env DAPR_GRPC_PORT='<DAPR_GRPC_PORT>' --env DAPR_API_TOKEN='<DAPR_API_TOKEN>' -- docker run -i --rm -e DAPR_GRPC_PORT -e DAPR_API_TOKEN ghcr.io/dapr/dapr-mcp-server:v0.0.3

### What are the best alternatives to Dapr MCP Server?

The closest alternatives to Dapr MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/dapr-mcp-server
