AI导哈

CRM模型协议服务器

基于.NET 9的Model Context Protocol服务器实现，提供云端部署模板和开发友好的热重载功能。

  • by Adesso-AlGu
  • C#
  • 本地部署
  • 更新于
在 GitHub 查看 Adesso-AlGu/CRMCopilotMCP

使用说明

CRM副驾驶MCP

📋 概述

CRM Copilot MCP是一个。基于 NET 9 的 MCP 服务器（模型上下文协议）。该仓库包含服务器部署和 Azure Bicep 模板，用于完整的云基础设施。

✨ 特性

  • 🔧 MCP服务器模型上下文协议（Model Context Protocol）
  • ☁️ Azure就绪用于云部署的预配置 Bicep 模板
  • 🚀 热重新加载： 易于开发，自动重新加载

🛠️ 条件

地方发展

Azure云部署

Azure AD 应用注册（用于身份验证）

  • 创建应用注册的 Azure AD 权限

🚀 快速启动

本地启动

# Repository klonen
git clone https://github.com/IHR_USERNAME/CRMCopilotMCP.git
cd CRMCopilotMCP

# Abhängigkeiten wiederherstellen (für alle Projekte)
dotnet restore src/mcp-csharp-sdk.sln

# Entwicklungsserver starten (z.B. Lead-Server)
dotnet run --project src/McpServer.Lead/McpServer.Lead.csproj
# Oder Opportunity-Server:
# dotnet run --project src/McpServer.Opportunity/McpServer.Opportunity.csproj
# Oder Quote-Server:
# dotnet run --project src/McpServer.Quote/McpServer.Quote.csproj

# (Optional) HTTP-Endpunkte testen
dotnet tool install --global Microsoft.dotnet-httprepl
httprepl http://localhost:5000

⚙️ 配置

地方发展

应用程序设置位于各自的项目目录中：

  • src/McpServer.Lead/appsettings.json
  • src/McpServer.Opportunity/appsettings.json
  • src/McpServer.Quote/appsettings.json

将开发特定值覆盖到相应的 appsettings.Development.json 文件

Azure Key Vault（生产版）

在生产环境中，所有秘密都会自动存储在 Azure Key Vault 中，并通过 Managed Identity 进行检索。基础设施由Bicep模块组成。 infra/ 提供的目录 ：

  • Client Secret 存储在 Key Vault Secret 中
  • 应用服务verwendet系统分配的托管身份
  • 自动 RBAC 角色分配：“Key Vault Secrets User”

项目结构

  • src/ MCP服务器实现（C#）
    • mcp-csharp-sdk.sln 适用于所有服务器的 Visual Studio 解决方案
    • McpServer.http – 所有端点的 HTTP 测试文件
    • McpServer.Lead/ –Lead管理服务器mit LeadTools
    • McpServer.Opportunity/ 带有 OpportunityTools 和 DataverseService 的机会管理服务器（包括 Azure AD 身份验证）
    • McpServer.Quote/ –报价管理服务器mit QuoteTools
  • infra/ Azure基础设施（Bicep模块）
    • 01-resource-group.bicep –资源组定义
    • 02-logging-monitoring.bicep – 记录和监控
    • 03-vnet.bicep –虚拟网络
    • 04-keyvault.bicep –密钥库
    • 05-appservice-mcp.bicep –应用服务
    • 06-apim-internal.bicep –API管理
    • 07-appservice-pe.bicep –私有端点
    • main.bicep –Haupt部署模板
    • main.parameters.json – 部署参数文件
  • helper/ – 帮助文件和示例
  • azure.yaml Azure Developer CLI 的部署配置

发展

  • Linting/Formatting 通过 dotnet format
  • 测试（如有）通过 dotnet test
  • 调试： dotnet watch run 支持 Hot Reload

🚀 部署

部署的要求

  1. Azure CLI 认证:
    az login
azd auth login
  2. 已配置参数 在 infra/main.parameters.json

Azure开发人员命令行界面（Empfohlen）

# Initialisierung
azd init

# Deployment
azd up

手动 Bicep 部署

使用 infra/main.bicep 对于手动配置：

az deployment sub create `
  --name crmcopilot-$(Get-Date -Format yyyyMMddHHmm) `
  --location "West Europe" `
  --template-file infra/main.bicep `
  --parameters @infra/main.parameters.json

更多信息

🐛 故障排除

构建错误

# Cache löschen und neu bauen
dotnet clean
dotnet restore
dotnet build

端口已在使用中

# Anderen Port verwenden
dotnet run --project src/McpServer.Lead/McpServer.Lead.csproj --urls "http://localhost:5001"
# oder für einen anderen Server entsprechend anpassen

Azure部署问题

# Deployment-Logs anzeigen
azd deploy --debug

# App Service Logs streamen
az webapp log tail --name app-<token> --resource-group <env>-rg

🔒 安全与最佳实践

发展

  • ✅ 使用 appsettings.Development.json 用于本地设置
  • ✅ 利用它。本地开发的 NET 用户秘密： dotnet user-secrets set "Key" "Value"
  • ✅ 启用 GitHub 秘密扫描
  • ❌ 永远不要在 Git 中提交秘密

生产

  • ✅ 将所有秘密存储在 Azure Key Vault 中
  • ✅ 用于服务对服务身份验证的托管身份
  • ✅ 强制使用 TLS 1.2+（已在 Bicep 中配置）
  • ✅ 启用 Application Insights 进行监控
  • ✅ 定期进行安全审计

合规

  • GDPR：确保按照 GDPR 处理个人数据
  • 记录：不记录敏感数据（秘密，PII）
  • 审核：启用 Azure AD 审核日志以获取合规性证据

📚 进一步的文档

📄 许可证

这个项目是根据麻省理工学院许可证授权的 - 参见 许可证 为了细节。

🤝 贡献

欢迎贡献！请注意：

  1. Fork des Repositories erstellen
  2. 创建 Feature Branch （git checkout -b feature/AmazingFeature)
  3. 提交更改（git commit -m 'Add some AmazingFeature')
  4. 蒲森分店(git push origin feature/AmazingFeature)
  5. 打开 Pull Request

📧 支持

如有任何问题或疑问，请创建 问题 im存储库。

相关 MCP