使用说明
工作区MCP服务器
用于Workzone API的模型上下文协议(MCP)服务器实现,使用Azure函数和C#构建。
概述
该MCP服务器提供了一个标准化接口,用于与Workzone的项目管理API进行交互。它实现了MCP协议,使AI助手和其他工具能够管理Workzone中的项目、任务、用户和时间跟踪。
特性
- 完成MCP实施:支持工具/列表、工具/调用和初始化方法
- 综合工具集:
- 项目管理(列表、获取、创建、更新、删除)
- 任务管理(列表、获取、创建、更新、删除)
- 用户管理(列表、获取、获取当前用户)
- 时间跟踪(列出、创建、更新、删除条目)
- 报告(项目状态、项目时间)
- 工作空间管理
- 企业就绪:
- 使用指数回退重试策略
- 令牌缓存和自动刷新
- 全面的错误处理
- 健康检查端点
- 应用洞察集成
- 结构化日志记录
先决条件
- .NET 8.0 SDK
- Azure功能核心工具v4
- 工作区API访问(需要企业许可证)
- Azure订阅(用于部署)
快速开始
-
克隆存储库
git clone https://github.com/KodachiQube/workzone-mcp-server.git cd workzone-mcp-server -
配置您的设置
cp src/WorkzoneMCP.Functions/local.settings.json.example src/WorkzoneMCP.Functions/local.settings.json # Edit local.settings.json with your Workzone API credentials -
构建并运行
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许可证-有关详细信息,请参阅许可证文件。