Harmonica MCP服务器
](https://www.npmjs.com/package/harmonica-mcp)
MCP服务器使AI代理能够创建和查询 口琴 审议会议。
口琴 是一个结构化的审议平台，小组通过人工智能促进的异步对话进行协调。创建一个包含主题和目标的会话，与参与者分享一个链接，每个人都可以与人工智能主持人进行一次1:1的私人对话。反应被综合成可操作的见解。 了解更多.
快速开始
1.获取API密钥
- 注册Harmonica （免费）
- 首选 个人资料 > API密钥 > 生成API密钥
- 复制您的
hm_live_...key——只显示一次
2.配置您的MCP客户端
添加到您的MCP客户端配置中（例如Claude Code、Cursor、Windsurf）：
{
"mcpServers": {
"harmonica": {
"command": "npx",
"args": ["-y", "harmonica-mcp"],
"env": {
"HARMONICA_API_KEY": "hm_live_your_key_here"
}
}
}
}3.开始审议
让你的AI代理创建一个会话：
创建一个关于“团队回顾”的口琴会议，目标是“回顾第一季度并确定改进”
与参与者共享加入URL。一旦他们做出回应，使用 get_responses 和 get_summary 看看结果。
工具
| 工具 | 说明 |
|---|---|
create_session | 创建一个新的审议会话并获取一个可共享的加入URL（可选： questions) |
update_session | 更新会话元数据（主题、目标、上下文、关键、提示） |
list_sessions | 列出您的审议会议（按状态筛选，搜索） |
get_session | 获取完整的会话详细信息（包括引导提示） |
get_questions | 获取会前问题（数据收集表） |
get_responses | 获取参与者的回复 |
get_summary | 获取AI生成的摘要 |
search_sessions | 按主题或目标搜索 |
list_telegram_groups | 列出注册到用户帐户的Telegram组（无参数） |
来源
git clone https://github.com/harmonicabot/harmonica-mcp.git
cd harmonica-mcp
npm install && npm run build然后使用 node /path/to/harmonica-mcp/dist/index.js 而不是 npx -y harmonica-mcp 在您的配置中。
环境变量
| 变量 | 必填 | 默认 | 描述 |
|---|---|---|---|
HARMONICA_API_KEY | 是 | - | 您的Harmonica API密钥 |
HARMONICA_API_URL | 没有 | https://app.harmonica.chat | API基本URL |
路线图
- \[\]通过以下方式安装一个命令
npx add-mcp（自动检测克劳德代码、光标、风帆） - \[\]HTTP传输--无需安装设置，只需添加一个URL
- \[\]入站上下文--通过MCP将外部数据馈送到会话中
- \[\]会话模板发现工具
- \[\]TypeScript和Python客户端SDK
另见
许可证
麻省理工学院