MCP Server Test H98

🚀 MCP 服務器測試

本項目主要進行 MCP 服務器的測試工作，按照官方指南原本使用 uv 構建環境，但實際改用 pyenv 來完成環境搭建，最終解決了運行時找不到 python 命令的問題。

🚀 快速開始

參考鏈接

可參考 MCP 快速入門指南 進行操作。

📦 安裝指南

環境搭建步驟

1. 安裝 Python 3.10 或更高版本
   按照要求，需先安裝 Python 3.11.5。
2. 設置為全局版本
   使用 pyenv 將 Python 3.11.5 設置為默認版本。

📚 詳細文檔

MCP 配置

根據官方示例，MCP 的配置文件如下：

{
    "mcpServers": {
        "weather": {
            "command": "python",
            "args": [
                "MY-PATH/mcp-server-test/src/main.py"
            ]
        }
    }
}

問題與解決

運行時出現以下錯誤：

2025-04-15T14:13:02.862Z [weather] [info] Initializing server...

2025-04-15T14:13:02.891Z [weather] [error] spawn python ENOENT {"context":"connection","stack":"Error: spawn python ENOENT\n  at ChildProcess._handle.onexit (node:internal/child_process:285:19)\n  at onErrorNT (node:internal/child_process:483:16)\n  at process.processTicksAndRejections (node:internal/process/task_queues:82:21)"}

2025-04-15T14:13:02.891Z [weather] [error] spawn python ENOENT {"stack":"Error: spawn python ENOENT\n  at ChildProcess._handle.onexit (node:internal/child_process:285:19)\n  at onErrorNT (node:internal/child_process:483:16)\n  at process.processTicksAndRejections (node:internal/process/task_queues:82:21)"}

2025-04-15T14:13:02.896Z [weather] [info] Server transport closed

2025-04-15T14:13:02.896Z [weather] [info] Client transport closed

2025-04-15T14:13:02.896Z [weather] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log.

2025-04-15T14:13:02.896Z [weather] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}

錯誤提示為找不到 python 命令。

解決方案

檢查 Python 的安裝路徑：

$ which python
MY-PATH/.pyenv/shims/python

修改 MCP 配置文件，指定完整的 Python 路徑：

{
    "mcpServers": {
        "weather": {
            "command": "MY-PATH/.pyenv/shims/python",
            "args": [
                "MY-PATH/mcp-server-test/src/main.py"
            ]
        }
    }
}

🔚 總結

通過指定完整的 Python 可執行文件路徑，成功解決了找不到 python 命令的問題。