holaspirit-mcp-server

holaspirit-mcp-server

site icon
2025.02.17 0
TypeScript组织管理协作工具交流协作
holaspirit-mcp-server 是一个基于 MCP(Model Context Protocol)的服务器,用于访问 Holaspirit API。该服务器提供了与 Holaspirit API 兼容的 MCP 访问接口,使 AI 助手能够通过标准化接口与您的 Holaspirit 数据进行交互。
View on GitHub

Overview

基本能力

产品定位

holaspirit-mcp-server 是一个中间件服务,旨在通过 MCP 协议标准化 Holaspirit API 的访问,方便 AI 助手或其他应用程序与 Holaspirit 平台进行交互。

核心功能

  • 提供对 Holaspirit 数据的标准化访问接口
  • 支持多种数据查询功能,包括任务、指标、圈子、角色、领域、政策和会议等

适用场景

  • AI 助手集成 Holaspirit 数据
  • 自动化工作流与 Holaspirit 平台的交互
  • 组织管理和协作工具的扩展开发

工具列表

  • list_tasks - 列出组织中的所有任务
  • list_metrics - 列出组织中的所有指标
  • list_circles - 列出组织中的所有圈子
  • get_circle - 获取特定圈子的详细信息
  • list_roles - 列出组织中的所有角色
  • get_role - 获取特定角色的详细信息
  • list_domains - 列出组织中的所有领域
  • list_policies - 列出组织中的所有政策
  • list_meetings - 列出组织中的所有会议
  • get_meeting - 获取特定会议的详细信息

常见问题解答

  1. 如何获取 Holaspirit API 凭证? 需要从 Holaspirit 平台获取 API token
  2. 如何指定组织 ID? 通过环境变量 EXAMPLES_CLIENT_HOLASPIRIT_ORGANIZATION_ID 设置

使用教程

使用依赖

  • Node.js 环境
  • npm 包管理器

安装教程

npm install holaspirit-mcp-server

创建 .env 文件配置 API 凭证:

HOLASPIRIT_API_TOKEN=your_api_token

调试方式

  1. 启动 MCP 服务器:
npx holaspirit-mcp-server
  1. 运行示例代码:
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 - 运行代码检查 - npm run fix - 自动修复代码格式问题

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。