Huly MCP服务器
一种MCP（模型上下文协议）服务器实现，提供对Huly平台API功能的访问。该服务器允许AI代理和LLM应用程序通过标准化的MCP协议与Huly项目、问题和其他平台功能进行交互。
特性
工具
- 列出问题：使用筛选和排序选项列出Huly项目中的问题
- 创建问题：使用标题、描述、优先级和分配创建新问题
- 得到问题：获取有关具体问题的详细信息
- 列出项目：列出所有可用的Huly项目
资源
- 项目信息：以JSON格式访问详细的项目信息
- 问题详细信息：以JSON格式访问详细的问题信息
提示
- 创建问题模板：用于创建结构良好的问题（错误、功能、任务、改进）的模板
- 项目评审模板：项目评审模板（冲刺、里程碑、季度）
安装
使用npx（推荐）
无需安装！您可以使用npx直接运行MCP服务器：
npx -y huly-mcp-server全球安装
npm install -g huly-mcp-server开发安装
git clone https://github.com/ThanabordeeN/hulyMCP.git
cd hulyMCP
npm install
npm run build配置
复制示例环境文件并配置Huly连接：
cp .env.example .env编辑 .env 使用您的Huly服务器详细信息：
# Huly server URL
HULY_URL=http://localhost:8087
# Workspace identifier
HULY_WORKSPACE=ws1
# Authentication (choose one method)
# Option 1: Token-based authentication
HULY_TOKEN=your_token_here
## Authentication
This project uses GitHub Packages for dependency management. To successfully download dependencies, you need to generate a GitHub personal access token and authenticate npm using that token.
1. Generate a GitHub Token
- Log in to your GitHub account
- Go to Settings > Developer settings > Personal access tokens (https://github.com/settings/personal-access-tokens)
- Click "Generate new token"
- Select the required scopes (at least `read:packages`)
- Generate the token and copy it
2. Authenticate with npm
npm login --registry=https://npm.pkg.github.com
出现提示时，输入您的GitHub用户名，并将生成的令牌用作密码。当被要求提供电子邮件地址时，请使用您的GitHub电子邮件。
注意：需要验证此过程才能成功安装依赖项。
# 选项2：电子邮件/密码身份验证
HULY.EMAIL=your_email@example.com
HULY_PASSWORD=您的密码
Usage
Running directly with npx
npx -y huly-mcp-server发展模式
npm run dev生产模式
npm run build
npm start与MCP客户端一起使用
此服务器使用MCP协议通过stdin/stdout进行通信。您可以将其与任何兼容MCP的客户端集成。
Claude Desktop示例
选项1：使用npx（推荐-无需安装）
添加到您的Claude Desktop MCP配置中：
{
"mcpServers": {
"huly": {
"command": "npx",
"args": ["-y", "huly-mcp-server"],
"env": {
"HULY_URL": "http://localhost:8087",
"HULY_WORKSPACE": "ws1",
"HULY_EMAIL": "user1",
"HULY_PASSWORD": "1234"
}
}
}
}选项2：本地安装
首先安装软件包：
npm install -g huly-mcp-server然后添加到您的Claude Desktop MCP配置中：
{
"mcpServers": {
"huly": {
"command": "huly-mcp-server",
"env": {
"HULY_URL": "http://localhost:8087",
"HULY_WORKSPACE": "ws1",
"HULY_EMAIL": "user1",
"HULY_PASSWORD": "1234"
}
}
}
}方案3：开发/当地建设
添加到您的Claude Desktop MCP配置中：
{
"mcpServers": {
"huly": {
"command": "node",
"args": ["/path/to/huly-mcp-server/dist/index.js"],
"env": {
"HULY_URL": "http://localhost:8087",
"HULY_WORKSPACE": "ws1",
"HULY_EMAIL": "user1",
"HULY_PASSWORD": "1234"
}
}
}
}例子
列出问题
// Tool call: list-issues
{
"projectIdentifier": "HULY",
"limit": 10,
"sortBy": "modifiedOn",
"sortOrder": "desc"
}创建问题
// Tool call: create-issue
{
"projectIdentifier": "HULY",
"title": "Fix login bug",
"description": "Users cannot log in with special characters in password",
"priority": "High"
}获取项目信息
// Resource: huly://project/HULY
// Returns detailed JSON information about the project使用问题创建模板
// Prompt: create-issue-template
{
"projectType": "bug",
"urgency": "high"
}api参考
工具
列出问题
列出指定Huly项目中的问题。
参数：
projectIdentifier（string）：项目标识符（例如“HULY”）limit（数字，可选）：要返回的最大问题数（默认值：20）sortBy（枚举，可选）：要排序的字段-“modifiedOn”、“createdOn”和“title”（默认值：“modifiedAn”）sortOrder（枚举，可选）：排序顺序-“asc”、“desc”（默认：“desc）
创建问题
在Huly项目中创建新问题。
参数：
projectIdentifier（string）：项目标识符title（string）：发行标题description（字符串，可选）：markdown格式的问题描述priority（枚举，可选）：问题优先级-“紧急”、“高”、“正常”、“低”（默认值：“正常”）assignee（字符串，可选）：受让人电子邮件或ID
得到问题
获取有关特定问题的详细信息。
参数：
issueIdentifier（string）：问题标识符（例如“HULY-123”）
列出项目
列出所有可用的Huly项目。
参数：
limit（number，可选）：要返回的最大项目数（默认值：50）
资源
项目信息
URI模式： huly://project/{identifier}
以JSON格式返回详细的项目信息。
问题详细信息
URI模式： huly://issue/{identifier}
以JSON格式返回详细的问题信息。
提示
创建问题模板
提供用于创建结构良好的问题的模板。
参数：
projectType（枚举）：问题类型-“错误”、“功能”、“任务”、“改进”urgency（枚举）：紧急程度-“低”、“中”、“高”、“严重”
项目评审模板
提供用于进行项目审查的模板。
参数：
projectIdentifier（string）：要查看的项目标识符reviewType（枚举）：审查类型-“冲刺”、“里程碑”、“季度”
需求
- Node.js>=18
- 访问Huly平台实例
- 有效的Huly工作区和身份验证凭据
依赖项
此MCP服务器构建于：
- @模型上下文协议/sdk：MCP TypeScript SDK
- @hcengineering/\*：Huly平台API客户端
许可证
麻省理工学院