mcpField
H
holaspirit-mcp-server

holaspirit-mcp-server

本地服务
npmjs.com商业与营销169 周前更新
代码仓库访问官网

关于 holaspirit-mcp-server

holaspirit-mcp-server 通过 Holaspirit API 为 AI 助手提供组织数据访问，可查看任务、指标、圈子、角色、会议等记录。

主要功能

  1. 01列出组织任务和指标
  2. 02浏览圈子、角色和领域
  3. 03获取政策及会议详情
  4. 04查看成员动态和会议张力
  5. 05通过电子邮件搜索成员

适用场景

  1. 01查看组织内的任务和指标
  2. 02检查圈子或角色的详情
  3. 03获取会议记录及相关张力
  4. 04通过电子邮件查找成员

MCP 相关

它将 Holaspirit API 操作作为工具提供给 MCP 客户端，支持 stdio 和 Streamable HTTP 传输方式。

#mcp#holaspirit#modelcontextprotocol

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "holaspirit": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli"
      ]
    }
  }
}
启动命令npx -y @smithery/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@smithery/cli

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

holaspirit-mcp-server

smithery badge npm version

一个可访问 Holaspirit API 的 MCP（Model Context Protocol） 服务。

此服务通过标准化接口提供与 MCP 兼容的 Holaspirit API 访问能力，让 AI 助手能够与您的 Holaspirit 数据交互。

Holaspirit Server MCP 服务

功能

可用工具：

  • 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 文件：

# Copy the example file
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 服务仅接受任意路径上的 POST 请求（例如 /、/mcp、/sse），并使用 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. Fork 此仓库
  2. 创建功能分支
  3. 运行测试和代码检查：npm run lint
  4. 提交更改
  5. 推送到分支
  6. 创建 Pull Request

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。