dapr MCP

dapr mcp

一个模型上下文协议（MCP）服务器，它将Dapr的微服务构建块作为AI代理的工具公开。

概述

dapr-mcp将AI代理与dapr强大的微服务API连接起来，实现：

• 状态管理：使用事务支持保存、检索和删除状态
• 发布/子消息：将事件发布到消息代理
• 服务调用：调用其他支持Dapr的服务
• 秘密管理：从配置的存储中安全访问机密
• 分布式锁定：协调共享资源的访问
• 绑定：与外部系统（数据库、队列等）交互
• 对话AI：通过Dapr将任务委派给外部LLM
• 密码学：加密和解密敏感数据

特性

• 完全开放遥测可观察性（跟踪、度量、日志）
• OAuth2.0/OIDC和SPIFFE身份验证支持
• Kubernetes就绪的健康端点
• 动态组件发现
• AI代理的全面安全规则

安装

来源

go install github.com/dapr/dapr-mcp-server/cmd/dapr-mcp-server@latest

从发布

从下载预构建的二进制文件 发布 页面。

码头工人

docker pull ghcr.io/dapr/dapr-mcp-server:latest
docker run -p 8080:8080 ghcr.io/dapr/dapr-mcp-server:latest

快速开始

1. 初始化Dapr：

dapr init

1. 运行MCP服务器：

dapr run --app-id dapr-mcp-server --resources-path components -- dapr-mcp-server --http localhost:8080

1. 将您的AI代理连接到 http://localhost:8080

工具状态

配置

环境变量

核心配置

开放遥测配置

验证配置

OIDC配置

SPIFFE配置

Dapr哨兵配置

健康终点

Kubernetes兼容的健康端点：

开放遥测

指标

跨度属性

每个工具跨度包括：

• tool.name：正在调用的工具
• tool.package：包含工具的包
• dapr.operation：Dapr操作类型
• dapr.component.type：使用的组件类型
• outcome：成功或错误

示例：Jaeger设置

# Start Jaeger
docker run -d --name jaeger \
  -p 16686:16686 \
  -p 4317:4317 \
  jaegertracing/all-in-one:latest

# Configure dapr-mcp
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4317
export OTEL_EXPORTER_OTLP_PROTOCOL=grpc

# Run server
dapr run --app-id dapr-mcp-server --resources-path components -- dapr-mcp-server --http localhost:8080

身份验证设置

OIDC（OAuth2.0）

export AUTH_ENABLED=true
export AUTH_MODE=oidc
export OIDC_ENABLED=true
export OIDC_ISSUER_URL=https://accounts.google.com
export OIDC_CLIENT_ID=your-client-id

史匹夫

export AUTH_ENABLED=true
export AUTH_MODE=spiffe
export SPIFFE_ENABLED=true
export SPIFFE_TRUST_DOMAIN=example.org
export SPIFFE_SERVER_ID=spiffe://example.org/dapr-mcp
export SPIFFE_ENDPOINT_SOCKET=unix:///tmp/spire-agent/public/api.sock

Dapr哨兵

对于使用Sentry但没有完整SPIRE基础设施的Dapr环境：

export AUTH_ENABLED=true
export AUTH_MODE=dapr-sentry
export DAPR_SENTRY_ENABLED=true
export DAPR_SENTRY_JWKS_URL=http://dapr-sentry:8080/jwks.json
export DAPR_SENTRY_TRUST_DOMAIN=public
export DAPR_SENTRY_AUDIENCE=public  # Optional

注： Dapr Sentry JWT在 sub 索赔但没有 iss 索赔， 这就是为什么他们需要这个专用的认证器而不是OIDC。

混合模式

接受多种身份验证方法（OIDC、SPIFFE和/或Dapr Sentry）：

export AUTH_ENABLED=true
export AUTH_MODE=hybrid
export OIDC_ENABLED=true
export OIDC_ISSUER_URL=https://accounts.google.com
export OIDC_CLIENT_ID=your-client-id
export SPIFFE_ENABLED=true
export SPIFFE_TRUST_DOMAIN=example.org
export SPIFFE_SERVER_ID=spiffe://example.org/dapr-mcp
# Optionally add Dapr Sentry as well:
# export DAPR_SENTRY_ENABLED=true
# export DAPR_SENTRY_JWKS_URL=http://dapr-sentry:8080/jwks.json
# export DAPR_SENTRY_TRUST_DOMAIN=public

IDE集成

VS Code

添加 .vscode/mcp.json:

{
  "servers": {
    "dapr-mcp": {
      "type": "http",
      "url": "http://localhost:8080"
    }
  }
}

克劳德桌面版

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "dapr-mcp": {
      "url": "http://localhost:8080"
    }
  }
}

发展

先决条件

• 转到1.21+
• Dapr命令行界面
• Docker（可选，用于本地测试）

建筑

go build -o dapr-mcp-server ./cmd/dapr-mcp-server

测试

go test -v -race ./...

代码检查

golangci-lint run

建筑

cmd/dapr-mcp-server/          # Main entry point
pkg/
  actors/             # Virtual actor tools
  auth/               # Authentication (OIDC, SPIFFE)
  bindings/           # Output binding tools
  conversation/       # LLM conversation tools
  crypto/             # Encryption/decryption tools
  health/             # Health check endpoints
  invoke/             # Service invocation tools
  lock/               # Distributed lock tools
  metadata/           # Component discovery
  mocks/              # Test mocks
  pubsub/             # Pub/Sub tools
  secrets/            # Secret management tools
  state/              # State management tools
  telemetry/          # OTEL instrumentation

贡献

欢迎投稿！拜托：

1. 克隆该仓库
2. 创建要素分支
3. 通过测试进行更改
4. 跑 golangci-lint run 和 go test ./...
5. 提交拉取请求

许可证

Apache 2.0-请参阅 许可证 了解详情。