Kognamcp

🚀 Kogna MCP Server

KognaのマルチエージェントAIアバターシステムと対話するためのツールを提供するモデルコンテキストプロトコル（MCP）サーバーです。

🚀 クイックスタート

Kogna MCP Serverを使用するには、まずインストールと設定が必要です。以下の手順に従って進めてください。

📦 インストール

pipxのインストール（まだインストールされていない場合）

# macOS
brew install pipx

# その他のシステム
pip install pipx

# pipxをPATHに追加する（まだ追加されていない場合）
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

kognamcpのインストール

pipx install kognamcp

インストールのテスト

コマンドが使用可能かテストする

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:
  # Run as MCP server (reads from stdin, writes to stdout)
  kognamcp
  
  # Test with echo (for development)
  echo '{"jsonrpc": "2.0", "method": "initialize", "id": 1}' | kognamcp

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"}}}

📚 ドキュメント

設定

kognamcpのパスを見つける

まず、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を使用できます。

• "Start a Kogna conversation"
• "List the available Kogna avatars"
• "Switch to the business room"
• "Ask the strategist avatar about market positioning"

必要条件

• Python 3.8以上
• インターネット接続（Kognaバックエンドに接続するため）

📄 ライセンス

MIT License