holaspirit-mcp-server

一个访问 Holaspirit API 的 MCP（模型上下文协议） 服务器。

该服务器提供了与 MCP 兼容的 Holaspirit API 访问，允许 AI 助手通过标准化接口与您的 Holaspirit 数据进行交互。

功能

可用工具：

• holaspirit_list_tasks - 列出组织中的所有任务
• holaspirit_list_metrics - 列出组织中的所有指标
• holaspirit_list_circles - 列出组织中的所有圈子
• holaspirit_get_circle - 获取特定圈子的详细信息
• holaspirit_list_roles - 列出组织中的所有角色
• holaspirit_get_role - 获取特定角色的详细信息
• holaspirit_list_domains - 列出组织中的所有领域
• holaspirit_list_policies - 列出组织中的所有策略
• holaspirit_list_meetings - 列出组织中的所有会议
• holaspirit_get_meeting - 获取特定会议的详细信息
• holaspirit_get_member_feed - 获取成员动态
• holaspirit_get_tensions - 获取会议或会议的紧张关系
• holaspirit_search_member - 通过电子邮件搜索成员

快速开始

安装

通过 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 令牌
• HOLASPIRIT_ORGANIZATION_ID: 您的 Holaspirit 组织 ID

使用 .env 文件

在项目根目录下创建一个 .env 文件：

# 复制示例文件
cp .env.example .env

然后编辑 .env 文件，填写实际值：

HOLASPIRIT_API_TOKEN=your_api_token_here
HOLASPIRIT_ORGANIZATION_ID=your_organization_id_here

使用

服务器支持两种传输模式：

Stdio 传输（默认）

用于通过 stdin/stdout 通信的 MCP 客户端：

npx holaspirit-mcp-server

HTTP 传输

用于 Web 客户端或基于 HTTP 的集成，使用最新的 Streamable HTTP 协议：

npx holaspirit-mcp-server --port 3000

HTTP 服务器仅接受任何路径（例如 /, /mcp, /sse）上的 POST 请求，并使用 Streamable HTTP 传输协议。

编辑客户端的 MCP 配置 json：

对于 stdio 传输：

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

对于 HTTP 传输，配置您的客户端连接到：

• http://localhost:3000/（或任何路径）

开发

可用脚本

• 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. 创建拉取请求