Workzone MCP Server

工作区MCP服务器

用于Workzone API的模型上下文协议（MCP）服务器实现，使用Azure函数和C#构建。

概述

该MCP服务器提供了一个标准化接口，用于与Workzone的项目管理API进行交互。它实现了MCP协议，使AI助手和其他工具能够管理Workzone中的项目、任务、用户和时间跟踪。

特性

• 完成MCP实施：支持工具/列表、工具/调用和初始化方法
• 综合工具集:

- 项目管理（列表、获取、创建、更新、删除） - 任务管理（列表、获取、创建、更新、删除） - 用户管理（列表、获取、获取当前用户） - 时间跟踪（列出、创建、更新、删除条目） - 报告（项目状态、项目时间） - 工作空间管理

• 企业就绪:

- 使用指数回退重试策略 - 令牌缓存和自动刷新 - 全面的错误处理 - 健康检查端点 - 应用洞察集成 - 结构化日志记录

先决条件

• .NET 8.0 SDK
• Azure功能核心工具v4
• 工作区API访问（需要企业许可证）
• Azure订阅（用于部署）

快速开始

1. 克隆存储库

   git clone https://github.com/KodachiQube/workzone-mcp-server.git
   cd workzone-mcp-server

1. 配置您的设置

   cp src/WorkzoneMCP.Functions/local.settings.json.example src/WorkzoneMCP.Functions/local.settings.json
   # Edit local.settings.json with your Workzone API credentials

1. 构建并运行

   dotnet restore
   dotnet build
   cd src/WorkzoneMCP.Functions
   func start

配置

更新 local.settings.json 使用您的Workzone API证书：

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "UseDevelopmentStorage=true",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated",
    "WorkzoneApi:BaseUrl": "https://[YOUR-ORGANIZATION].sharedwork.com",
    "WorkzoneApi:ClientId": "[YOUR-CLIENT-ID]",
    "WorkzoneApi:ClientSecret": "[YOUR-CLIENT-SECRET]",
    "WorkzoneApi:TokenEndpoint": "/api/token",
    "WorkzoneApi:ApiVersion": "v1"
  }
}

可用工具

通过调用MCP查看可用工具的完整列表 tools/list 方法。

许可证

MIT许可证-有关详细信息，请参阅许可证文件。