Syucream Holaspirit MCP Server

🚀 holaspirit-mcp-server

holaspirit-mcp-server 是一个实现 MCP（模型上下文协议） 的服务器，旨在为用户提供访问 Holaspirit API 的便捷途径。该服务器提供了与 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 - 获取特定会议的详细信息

🚀 快速开始

📦 安装指南

使用以下命令安装 holaspirit-mcp-server：

npm install holaspirit-mcp-server

🔧 配置

创建一个 .env 文件，并在其中添加您的 Holaspirit API 凭证：

HOLASPIRIT_API_TOKEN=your_api_token

💻 使用示例

基础用法

1. 启动 MCP 服务器：

npx holaspirit-mcp-server

2. 若要查看示例用法，请参考 examples 目录。运行示例前，需要设置所需的环境变量：

# 设置所需的环境变量
export EXAMPLES_CLIENT_HOLASPIRIT_API_TOKEN=your_api_token
export EXAMPLES_CLIENT_HOLASPIRIT_ORGANIZATION_ID=your_organization_id

# 运行示例
npm run examples

🛠️ 开发

🔧 可用脚本

• npm run dev - 以开发模式启动服务器，支持热重载
• npm run build - 构建项目用于生产环境
• npm run start - 启动生产服务器
• npm run lint - 执行代码检查（ESLint 和 Prettier）
• npm run fix - 自动修复代码问题
• npm run examples - 运行示例脚本

🤝 贡献指南

如果您想为该项目做出贡献，请按照以下步骤操作：

1. Fork 该仓库
2. 创建功能分支
3. 运行测试和代码检查：npm run lint
4. 提交更改
5. 推送到分支
6. 提交 Pull Request