Holaspirit MCP Server

holaspirit mcp服务器

A. MCP（模型上下文协议） 访问的服务器 API好事利.

该服务器提供对Holaspirit API的MCP-兼容访问，允许人工智能助手通过标准化界面与您的Holasperit数据交互。

特性

可用工具：

• 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安装

通过以下方式自动为Claude Desktop安装holaspirit mcp服务器 史密瑟里:

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

用法

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

标准传输（默认）

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

npx holaspirit-mcp-server

HTTP传输

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

npx holaspirit-mcp-server --port 3000

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

为您的客户端编辑MCP配置json：

对于stdio传输：

...
    "holaspirit": {
      "command": "npx",
      "args": [
        "-y",
        "holaspirit-mcp-server"
      ],
      "env": {
        "HOLASPIRIT_API_TOKEN": "",
        "HOLASPIRIT_ORGANIZATION_ID": ""
      }
    },
...

对于HTTP传输，请将客户端配置为连接到：

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

发展

可用脚本

• npm run dev -以热重新加载的开发模式启动服务器
• npm run build -建设生产项目
• npm run start -启动生产服务器
• npm run lint -运行linting检查（ESLint和Prettier）
• npm run fix -自动修复掉毛问题
• npm run examples -运行示例脚本

贡献

1. 分叉存储库
2. 创建功能分支
3. 运行测试和梳理： npm run lint
4. 提交您的更改
5. 推到分支
6. 创建拉取请求