Kognamcp

🚀 Kogna MCP Server

🤖 Kogna MCP Server 是一个模型上下文协议（MCP）服务器，它提供了与 Kogna 多智能体 AI 化身系统进行交互的工具，能增强系统的交互性和功能性。

🚀 快速开始

Kogna MCP Server 为用户提供了与 Kogna 多智能体 AI 化身系统交互的能力。以下将详细介绍其安装、测试、配置、故障排除、可用工具、使用方法及相关要求。

📦 安装指南

安装 pipx（若尚未安装）

# macOS 系统
brew install pipx

# 其他系统
pip install pipx

# 将 pipx 添加到环境变量 PATH 中（若尚未添加）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

安装 kognamcp

pipx install kognamcp

💻 使用示例

基础用法

测试安装是否成功

1. 测试命令是否可用

kognamcp --help

预期输出如下：

usage: kognamcp [-h]

Kogna MCP Bridge - Forwards MCP requests to the Kogna HTTP server

options:
  -h, --help  show this help message and exit

Examples:
  # 作为 MCP 服务器运行（从标准输入读取，写入标准输出）
  kognamcp
  
  # 开发时使用 echo 进行测试
  echo '{"jsonrpc": "2.0", "method": "initialize", "id": 1}' | kognamcp

2. 测试 MCP 桥接连接

echo '{"jsonrpc": "2.0", "method": "initialize", "id": 1}' | kognamcp

预期响应如下：

{"jsonrpc": "2.0", "id": 1, "result": {"protocolVersion": "2024-11-05", "capabilities": {"tools": {}}, "serverInfo": {"name": "kognamcp-server", "version": "1.0.0"}}}

高级用法

配置 MCP 客户端

查找 kognamcp 命令的完整路径

which kognamcp

此命令将输出类似 /Users/username/.local/bin/kognamcp 的内容。

配置 MCP 客户端

将以下配置添加到 MCP 客户端：

{
  "mcpServers": {
    "kognamcp": {
      "command": "FULL_PATH_FROM_WHICH_COMMAND"
    }
  }
}

请将 FULL_PATH_FROM_WHICH_COMMAND 替换为 which kognamcp 的输出结果。

例如，若 which kognamcp 返回 /Users/john/.local/bin/kognamcp，则配置应如下：

{
  "mcpServers": {
    "kognamcp": {
      "command": "/Users/john/.local/bin/kognamcp"
    }
  }
}

🔧 故障排除

出现 “Command not found: kognamcp” 错误

1. 确保安装成功：

pipx list | grep kognamcp

2. 将 pipx 添加到环境变量 PATH 中：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

3. 重启终端或 IDE。

出现 “spawn kognamcp ENOENT” 或类似错误

当 MCP 客户端无法找到 kognamcp 命令时会出现此错误，解决方法是使用完整路径：

1. 查找完整路径：

which kognamcp

2. 复制精确输出并在 MCP 配置中使用。
3. 重启 MCP 客户端。

连接错误

桥接器连接到 https://kogna.up.railway.app/mcp，请确保你有网络连接。

📚 详细文档

可用工具

• start_kogna_conversation - 与 Kogna 化身开启新对话
• send_kogna_message - 向当前对话发送消息
• list_kogna_avatars - 列出可用化身及其专长
• list_kogna_rooms - 列出可用房间及其描述
• switch_kogna_avatar - 切换到不同的化身
• switch_kogna_room - 切换到不同的房间
• get_kogna_conversation_history - 获取对话历史记录
• get_kogna_system_info - 获取系统信息

使用方法

配置完成后，你可以通过 MCP 客户端使用 Kogna：

• “开启 Kogna 对话”
• “列出可用的 Kogna 化身”
• “切换到商务房间”
• “向策略师化身询问市场定位问题”

系统要求

• Python 3.8 及以上版本
• 网络连接（连接到 Kogna 后端）

📄 许可证

本项目采用 MIT 许可证。