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 許可證。