workzonemcp (Kodachiqube)

工作区MCP服务器

一种模型上下文协议（MCP）服务器，为AI助手提供对工作区案例管理功能的访问。此服务器既可以作为Azure功能运行，也可以作为独立的MCP服务器运行。

特性

• 事件管理：获取、创建、更新和搜索工作区案例
• 双模式：作为Azure Function或独立MCP服务器运行
• 坚韧的：内置重试策略和断路器
• 可观察对象：应用洞察集成
• 类型安全：用C#8.0完全键入

先决条件

• .NET 8.0 SDK
• Azure功能核心工具v4（适用于Azure功能模式）
• 工作区API证书

项目结构

WorkzoneMCP/
├── src/
│   ├── WorkzoneMCP.Core/          # Core models and interfaces
│   ├── WorkzoneMCP.Functions/     # Azure Functions and MCP server
│   ├── WorkzoneMCP.Services/      # Business logic and API clients
│   └── WorkzoneMCP.Tests/         # Unit and integration tests
├── scripts/                       # Utility scripts
└── docs/                         # Documentation

配置

环境变量

• App__WorkzoneApiUrl：工作区API基本URL
• App__WorkzoneApiKey：工作区API密钥
• App__TimeoutSeconds：HTTP超时（默认值：30）
• App__MaxRetryAttempts：最大重试次数（默认值：3）
• App__RetryDelayMilliseconds：基本重试延迟（默认值：1000）

本地设置

更新 src/WorkzoneMCP.Functions/local.settings.json:

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "App__WorkzoneApiUrl": "https://api.workzone.com",
    "App__WorkzoneApiKey": "your-api-key-here"
  }
}

运行服务器

作为MCP服务器

# Using the script
./scripts/run-mcp-server.sh

# Or directly
cd src/WorkzoneMCP.Functions
dotnet run -- --mcp

作为Azure功能

# Using the script
./scripts/run-azure-function.sh

# Or directly
cd src/WorkzoneMCP.Functions
func start

可用工具

workzone_get_case

从Workzone按ID获取案例。

参数：

• caseId （string，必填）：要检索的案例的ID

工作区_创建_案例

在Workzone中创建新案例。

参数：

• title （string，必填）：案例标题
• description （字符串，可选）：案例描述
• caseType （字符串，可选）：案例类型

工作区更新案例

更新工作区中的现有案例。

参数：

• caseId （string，必填）：要更新的案例的ID
• title （字符串，可选）：新标题
• description （字符串，可选）：新描述
• status （字符串，可选）：新状态

工作区搜索案例

在工作区中搜索案例。

参数：

• query （字符串，必填）：搜索查询

测试

运行单元测试

cd src/WorkzoneMCP.Tests
dotnet test

测试MCP服务器

./scripts/test-mcp-server.sh

与Claude Desktop集成

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "workzone": {
      "command": "dotnet",
      "args": ["run", "--project", "/path/to/WorkzoneMCP/src/WorkzoneMCP.Functions", "--", "--mcp"],
      "env": {
        "App__WorkzoneApiUrl": "https://api.workzone.com",
        "App__WorkzoneApiKey": "your-api-key"
      }
    }
  }
}

发展

添加新工具

1. 在中添加工具定义 McpServer.cs
2. 实现处理程序方法
3. 在中添加相应的服务方法 IWorkzoneService
4. 在中实现服务逻辑 WorkzoneService
5. 添加测试

建筑

dotnet build

出版

dotnet publish -c Release

故障排除

常见问题

1. 连接被拒绝：确保API工作区可访问
2. 认证失败：检查API密钥配置
3. 超时错误：增加 TimeoutSeconds 设置

日志记录

• Azure功能模式：检查应用程序洞察
• MCP模式：带有日志级别的控制台输出

许可证

\[您的许可证在这里\]

贡献

\[您的投稿指南请点击此处\]