Holaspirit MCP服务
提供与MCP兼容的访问Holaspirit API的方式，允许AI助手通过标准化接口与组织数据（如任务、圈子、角色和会议）进行交互。
可用工具 （10 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
list_tasks 1 个参数 需填 1 项
List all tasks in the organization
必填参数：organizationId
list_metrics 1 个参数 需填 1 项
List all metrics in the organization
必填参数：organizationId
list_circles 1 个参数 需填 1 项
List all circles in the organization
必填参数：organizationId
get_circle 2 个参数 需填 2 项
Get details of a specific circle
必填参数：organizationId、circleId
list_roles 1 个参数 需填 1 项
List all roles in the organization
必填参数：organizationId
get_role 2 个参数 需填 2 项
Get details of a specific role
必填参数：organizationId、roleId
list_domains 1 个参数 需填 1 项
List all domains in the organization
必填参数：organizationId
list_policies 1 个参数 需填 1 项
List all policies in the organization
必填参数：organizationId
list_meetings 1 个参数 需填 1 项
List all meetings in the organization
必填参数：organizationId
get_meeting 2 个参数 需填 2 项
Get details of a specific meeting
必填参数：organizationId、meetingId
服务介绍
holaspirit-mcp-server
一个可以访问Holaspirit API的MCP（模型上下文协议）服务器。
该服务器提供了与Holaspirit API兼容的MCP访问方式，允许AI助手通过标准化接口与您的Holaspirit数据进行交互。
功能
可用工具：
list_tasks- 列出组织中的所有任务list_metrics- 列出组织中的所有指标list_circles- 列出组织中的所有圈子get_circle- 获取特定圈子的详细信息list_roles- 列出组织中的所有角色get_role- 获取特定角色的详细信息list_domains- 列出组织中的所有领域list_policies- 列出组织中的所有政策list_meetings- 列出组织中的所有会议get_meeting- 获取特定会议的详细信息
快速开始
安装
通过Smithery安装
要通过Smithery自动为Claude Desktop安装holaspirit-mcp-server：
npx -y @smithery/cli install holaspirit-mcp-server --client claude
手动安装
npm install holaspirit-mcp-server
配置
HOLASPIRIT_API_TOKEN: 您的Holaspirit API令牌
使用
启动MCP服务器
直接启动：
npx holaspirit-mcp-server
或者使用node运行已安装的模块。
编辑客户端的MCP配置json文件：
...
"lightdash": {
"command": "npx",
"args": [
"-y",
"holaspirit-mcp-server"
],
"env": {
"HOLASPIRIT_API_TOKEN": "<your token>"
}
},
...
开发
可用脚本
npm run dev- 以开发模式启动服务器并启用热重载npm run build- 构建生产项目npm run start- 启动生产服务器npm run lint- 运行代码检查（ESLint和Prettier）npm run fix- 自动修复代码检查问题npm run examples- 运行示例脚本
贡献
- Fork仓库
- 创建您的功能分支
- 运行测试和代码检查：
npm run lint - 提交更改
- 推送到分支
- 创建Pull Request
