Back to MCP directory
publicPublicdnsLocal runtime

holaspirit-mcp-server

一个提供Holaspirit API访问的MCP服务器,允许AI助手通过标准化接口与Holaspirit数据进行交互。

article

README

🚀 holaspirit-mcp-server

这是一个支持MCP(模型上下文协议)的服务器,可连接到Holaspirit API。它为Holaspirit的API提供MCP兼容访问,允许AI助手通过标准接口与您的Holaspirit数据进行交互。

🚀 快速开始

📦 安装指南

通过Smithery安装

要自动为Claude Desktop安装holaspirit-mcp-server,请访问Smithery

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.js启动已安装的模块。

编辑客户端的MCP配置json:

...
    "lightdash": {
      "command": "npx",
      "args": [
        "-y",
        "holaspirit-mcp-server"
      ],
      "env": {
        "HOLASPIRIT_API_TOKEN": "<your token>"
      }
    },
...

✨ 主要特性

可用工具:

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

🔧 技术细节

可用脚本

  • npm run dev - 以开发模式启动服务器,带有热重载功能
  • npm run build - 构建项目用于生产环境
  • npm run start - 启动生产服务器
  • npm run lint - 运行代码检查(ESLint和Prettier)
  • npm run fix - 自动修复代码问题
  • npm run examples - 运行示例脚本

贡献指南

  1. 叉取仓库
  2. 创建功能分支
  3. 运行测试和代码检查:npm run lint
  4. 提交更改
  5. 推送到分支
  6. 提交拉取请求

📄 许可证

文档中未提及许可证相关信息,故该章节跳过。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client