MCP Chat

🚀 mcp-chat

オープンソースの汎用MCPクライアントで、MCPサーバーとプロキシのテストおよび評価に使用されます。

🚀 クイックスタート

ANTHROPIC_API_KEY環境変数をシステム環境にエクスポートするか、プロジェクトのルートディレクトリにある.envファイルで設定してください。APIキーはAnthropicコンソールのキーページで登録して取得できます。

簡単な使用例：コマンドラインからファイルシステムMCPサーバーを起動し、対話型チャットプロンプトを開始します。

npx mcp-chat --server "npx -y @modelcontextprotocol/server-filesystem /Users/$USER/Desktop"

これにより、サーバーと対話し、LLMを使用した会話を行うためのチャットプロンプトが開きます。

📦 インストール

設定方法

claude_desktop_config.jsonファイルを指定することで、設定を行うことができます（Macシステム）。

npx mcp-chat --config "/Users/あなたのユーザー名/.config/autocad/acad2018/chloroform/chain"

Windowsシステムの場合は、次のように指定します。

npx mcp-chat --config "C:\Users\あなたのユーザー名\AppData\Roaming\AutoCAD\\2018\ChloroForm\Chain"

ウェブモードの起動

--webフラグを使用してウェブモードを起動することができ、ブラウザで使用できます。

npx mcp-chat --web

ANTHROPIC_API_KEY環境変数が設定されていることを確認してください。

✨ 主な機能

• 対話型チャット：コマンドラインからの会話をサポートします。
• 任意のMCPサーバーへの接続：任意のMCPサーバーに接続できます。
• 複数のモデルサポート：異なるLLMモデルと互換性があります。
• コンテキスト感知：コンテキストを理解し、より自然な会話を実現します。

📚 ドキュメント

コマンドラインオプション

npx mcp-chat [オプション]

利用可能なオプション：

• --server, -s：MCPサーバーのアドレスを指定します。デフォルトはhttp://localhost:8080です。
• --web, -w：ウェブモードを起動し、ブラウザで使用します。
• --config, -c：設定ファイルのパスを指定します。
• --version, -v：現在のバージョン番号を表示します。
• --help, -h：ヘルプ情報を表示します。

使い方の例

1. コマンドラインから会話を開始する：

npx mcp-chat --server http://localhost:8080 -p "デスクトップディレクトリ内のファイルをリストする"

2. ウェブモードを起動する：

npx mcp-chat --web

🔧 技術詳細

MCPサーバーのテスト用接続

MCPサーバーを開発する際には、次のコマンドでmcp-chatをテストできます。

Node.js環境

npm install @modelcontextprotocol/server-file-system
node -e "require('@modelcontextprotocol/server-file-system').start(8080)"

その後、mcp-chatを使って会話を開始します。

npx mcp-chat --server http://localhost:8080 -p "デスクトップディレクトリ内のファイルをリストする"

Python環境

Pythonの依存関係をインストールします。

pip install modelcontextprotocol-server-file-system
python3 -m modelcontextprotocol.server_file_system.start 8080

その後、mcp-chatを使って会話を開始します。

npx mcp-chat --server http://localhost:8080 -p "デスクトップディレクトリ内のファイルをリストする"

プロジェクト構造

├── src/
│   ├── index.ts            # メインクライアントの実装とCLIパラメータの処理
│   ├── constants.ts        # デフォルトの定数定義
│   └── interactive.ts      # 対話型チャットプロンプトのロジック
└── test/                   # テストフォルダ
    ├── cli.test.ts         # CLIパラメータのテスト
    └── config.test.ts      # 設定ファイルの解析テスト

新しいバージョンのリリース

Githubのリリースページにアクセスし、「新しいリリース」ボタンをクリックします。「タグを追加」を選択し、新しいセマンティックバージョン番号v{メジャーバージョン}.{マイナーバージョン}.{パッチバージョン}を作成します。リリースタイトル「リリースv{メジャーバージョン}.{マイナーバージョン}.{パッチバージョン}」と変更ログを入力し、「リリース」をクリックします。

package.jsonのバージョン番号を手動で更新する必要はありません。GitHubのワークフローが自動的に処理し、メインブランチにプッシュします。

📄 ライセンス

MITライセンス