MCP Chat

🚀 mcp-chat

mcp-chat 是一個開源通用的 MCP 客戶端，主要用於對 MCP 服務器與代理進行測試和評估，能幫助開發者高效驗證相關服務的性能與功能。

🚀 快速開始

請確保已將ANTHROPIC_API_KEY環境變量導出到系統環境中，或者在項目根目錄下的.env文件裡進行設置。您可以前往Anthropic 控制檯密鑰頁面註冊並獲取 API 密鑰。

下面是一個簡單用例，可從命令行啟動一個帶有文件系統 MCP 服務器的交互式聊天提示：

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

執行上述命令後，會打開一個聊天提示界面，您可以通過它與服務器交互，並使用大語言模型（LLM）進行對話。

✨ 主要特性

• 交互式聊天：支持從命令行發起對話，方便快捷。
• 連接任何 MCP 服務器：可以與任意 MCP 服務器建立連接，具有良好的兼容性。
• 支持多種模型：兼容不同的大語言模型（LLM），滿足多樣化需求。
• 上下文感知：具備上下文理解能力，讓對話更加連貫自然。

📦 安裝指南

本項目無需複雜的安裝步驟，通過npx命令即可直接使用。前提是要完成ANTHROPIC_API_KEY環境變量的設置。

💻 使用示例

基礎用法

從命令行發起對話：

npx mcp-chat --server http://localhost:8080 -p "列出桌面目錄下的文件"

高級用法

配置文件使用

您可以通過指定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環境變量。

📚 詳細文檔

命令行選項

npx mcp-chat [選項]

可用選項如下：

🔧 技術細節

項目架構

├── src/
│   ├── index.ts            # 主客戶端實現與 CLI 參數處理
│   ├── constants.ts        # 默認常量定義
│   └── interactive.ts      # 交互式聊天提示邏輯
└── test/                   # 測試文件夾
    ├── cli.test.ts         # CLI 參數測試
    └── config.test.ts      # 配置文件解析測試

開發者指南

連接 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 "列出桌面目錄下的文件"

📄 許可證

本項目採用MIT 許可證。

發佈新版本

訪問Github 發佈頁面，點擊“新建發佈”按鈕，選擇“添加標籤”，創建新的語義化版本號v{主版本}.{次版本}.{修訂版本}。填寫發佈標題“發佈 v{主版本}.{次版本}.{修訂版本}”及變更日誌，最後點擊“發佈”。無需手動更新package.json中的版本號，因為 GitHub 工作流會自動處理並推送到主線分支。