Holaspirit Mcp 服务器

什么是 Holaspirit MCP 服务器？

Holaspirit MCP 服务器是一个强大的工具，旨在促进对 Holaspirit 平台的无缝访问。它作为中间件连接各种应用程序和服务，使用户能够高效地与 Holaspirit 的功能和特性进行交互。这个服务器对于希望将 Holaspirit 集成到现有系统中或创建利用 Holaspirit 能力的新应用程序的开发者特别有用。

Holaspirit MCP 服务器的特点

• 简单集成：Holaspirit MCP 服务器简化了连接到 Holaspirit 平台的过程，使开发者更容易将其功能集成到他们的应用程序中。
• 中间件功能：充当不同服务之间的桥梁，确保顺畅的通信和数据交换。
• 强大的 API 支持：提供全面的 API，使开发者能够访问 Holaspirit 的各种功能，增强整体用户体验。
• 开源：作为一个公共存储库，开发者可以参与其开发，根据自己的需求进行定制，并受益于社区支持。
• 文档和社区支持：配备丰富的文档和活跃的社区，使用户更容易找到帮助和资源。

如何使用 Holaspirit MCP 服务器

1. 安装：首先通过 npm 安装 Holaspirit MCP 服务器。您可以在终端中运行以下命令：

   npm install holaspirit-mcp-server
   

2. 配置：安装后，通过设置必要的环境变量和配置文件来配置服务器，以连接到您的 Holaspirit 账户。

3. 启动服务器：使用以下命令启动服务器：

   npm start
   

4. 访问 API：一旦服务器运行，您可以访问 API 端点与 Holaspirit 的功能进行交互。请参考文档以获取有关可用端点及其使用的详细信息。

5. 开发您的应用程序：使用 API 构建您的应用程序，根据需要集成 Holaspirit 的功能。

常见问题解答

Q1: Holaspirit MCP 服务器的目的是什么？

A1: Holaspirit MCP 服务器旨在为开发者提供一种简单的方法，以访问和集成 Holaspirit 的功能到他们的应用程序中。

Q2: Holaspirit MCP 服务器是免费使用的吗？

A2: 是的，Holaspirit MCP 服务器是开源的，并且在 npm 上免费提供。

Q3: 我在哪里可以找到 Holaspirit MCP 服务器的文档？

A3: 文档可以在 npm 包页面 和存储库中找到。

Q4: 我可以为 Holaspirit MCP 服务器做贡献吗？

A4: 当然可以！作为一个开源项目，欢迎贡献。您可以分叉存储库，进行更改，并提交拉取请求。

Q5: Holaspirit MCP 服务器使用了哪些技术？

A5: 该服务器使用 Node.js 构建，能够高效处理异步操作，并为 API 交互提供强大的环境。

holaspirit-mcp-server

A MCP(Model Context Protocol) server that accesses to Holaspirit API.

This server provides MCP-compatible access to Holaspirit's API, allowing AI assistants to interact with your Holaspirit data through a standardized interface.

<a href="https://glama.ai/mcp/servers/7tn35lri9w"><img width="380" height="200" src="https://glama.ai/mcp/servers/7tn35lri9w/badge" alt="Holaspirit Server MCP server" /></a>

Features

Available tools:

• holaspirit_list_tasks - List all tasks in the organization
• holaspirit_list_metrics - List all metrics in the organization
• holaspirit_list_circles - List all circles in the organization
• holaspirit_get_circle - Get details of a specific circle
• holaspirit_list_roles - List all roles in the organization
• holaspirit_get_role - Get details of a specific role
• holaspirit_list_domains - List all domains in the organization
• holaspirit_list_policies - List all policies in the organization
• holaspirit_list_meetings - List all meetings in the organization
• holaspirit_get_meeting - Get details of a specific meeting
• holaspirit_get_member_feed - Get member feed
• holaspirit_get_tensions - Get tensions for a meeting or meetings
• holaspirit_search_member - Search for a member by email

Quick Start

Installation

Installing via Smithery

To install holaspirit-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install holaspirit-mcp-server --client claude

Manual Installation

npm install holaspirit-mcp-server

Configuration

You can configure the server using environment variables. Two methods are supported:

Environment Variables

• HOLASPIRIT_API_TOKEN: Your Holaspirit API token
• HOLASPIRIT_ORGANIZATION_ID: Your Holaspirit organization ID

Using .env File

Create a .env file in the project root:

### Copy the example file
cp .env.example .env

Then edit .env with your actual values:

HOLASPIRIT_API_TOKEN=your_api_token_here
HOLASPIRIT_ORGANIZATION_ID=your_organization_id_here

Usage

The server supports two transport modes:

Stdio Transport (Default)

For use with MCP clients that communicate via stdin/stdout:

npx holaspirit-mcp-server

HTTP Transport

For use with web clients or HTTP-based integrations using the latest Streamable HTTP protocol:

npx holaspirit-mcp-server --port 3000

The HTTP server accepts POST requests only on any path (e.g., /, /mcp, /sse) and uses the Streamable HTTP transport protocol.

Edit MCP configuration json for your client:

For stdio transport:

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

For HTTP transport, configure your client to connect to:

• http://localhost:3000/ (or any path)

Development

Available Scripts

• npm run dev - Start the server in development mode with hot reloading
• npm run build - Build the project for production
• npm run start - Start the production server
• npm run lint - Run linting checks (ESLint and Prettier)
• npm run fix - Automatically fix linting issues
• npm run examples - Run the example scripts

Contributing

1. Fork the repository
2. Create your feature branch
3. Run tests and linting: npm run lint
4. Commit your changes
5. Push to the branch
6. Create a Pull Request