Quack MCP Server

🚀 鴨叫（Quack）指南

鴨叫（Quack）是一個基於模型上下文協議（MCP）構建的Python代碼分析服務器。它支持多種代碼分析工具，還能通過C語言擴展（C Extension）與Visual Studio Code集成，為Python開發提供即時反饋，助力開發者高效完成代碼開發。

🚀 快速開始

運行服務器

python3 quack.py --stdio

默認情況下，服務器綁定本地IP地址的8000端口。要指定其他主機或端口，請使用以下命令：

python3 quack.py --stdio --host <主機> --port <端口>

使用示例代碼

以下是包含多種問題的示例代碼，用於測試服務器的功能：

# 錯誤用法示例：
unused_var = 42  # 未使用的變量
x = 10  # 單字母變量名
print("Hello, World!")  # 缺少換行符

# 類型錯誤示例：
def add(a: int, b: int) -> int:
    return a + b

result = add("5", 10)  # 類型錯誤：字符串和整數相加

將此代碼粘貼到C語言擴展中，Quack服務器會自動檢測並報告問題。

✨ 主要特性

• 基於模型上下文協議（MCP）構建，為Python代碼分析提供強大支持。
• 支持多種代碼分析工具，如Pylint和Mypy，可全面檢測代碼問題。
• 通過C語言擴展與Visual Studio Code集成，為Python開發提供即時反饋。

📦 安裝指南

安裝依賴項

在運行Quack之前，請確保安裝了以下工具：

• Python 3.8或更高版本
• Docker（僅適用於SSE模式）
• pip

然後安裝所需的Python包：

pip install quack

運行鴨叫服務器

鴨叫服務器有兩種運行模式：標準輸入輸出模式和流式交換擴展模式。

標準輸入輸出模式

直接運行Python腳本：

python3 -m quack.server --stdio

默認情況下，服務器監聽本地IP地址的8000端口。要指定不同的主機或端口，請使用以下命令：

python3 -m quack.server --stdio --host <主機> --port <端口>

流式交換擴展模式

通過Docker運行：

docker run -p 8000:8000 quack/mcp-server

🔧 配置與集成

配置Quack服務器

創建配置文件quack_server_config.json，並添加以下內容：

{
    "name": "Python Linter",
    "command": "python3 -m quack.server --stdio",
    "args": [],
    "stdinHandler": {
        "type": "stdio"
    },
    "schemes": ["file"],
    "language": "python",
    "dllLoadMessage": ""
}

將此配置文件添加到Visual Studio Code的settings.json中：

{
    "extensions.csharpEnableCodeLens": false,
    "extensions.csharpShowSnippetsOnHover": false,
    "extensions.pythonVSQuackServer": "/path/to/quack_server_config.json"
}

💻 使用示例

標準輸入輸出模式

在終端中運行：

python3 -m quack.server --stdio

然後使用以下命令與服務器交互：

# 提交新作業
curl -X POST http://localhost:8000/queue \
     -H "Content-Type: application/json" \
     -d '{"tool":"pylint","content":"print(\"Hello, World!\")"}'

# 檢查作業狀態
curl http://localhost:8000/queue/<JOB_ID>

# 獲取分析結果
curl http://localhost:8000/results/<RESULT_ID>

流式交換擴展模式

通過以下命令訪問：

http://localhost:8000/sse

📚 詳細文檔

Quack支持多種代碼分析工具，包括：

• Pylint：用於檢測代碼風格和質量問題。
• Mypy：用於靜態類型檢查。

如需瞭解更多信息，請訪問官方文檔。