MCP Server 95i

🚀 mcp-server

本項目主要用於學習編寫 mcp 服務器，幫助開發者掌握相關技能。

🚀 快速開始

本項目可通過命令行進行安裝，下面將詳細介紹安裝步驟。

📦 安裝指南

使用 Smithery 安裝

通過 Smithery 可自動安裝 Claude Desktop 的 mcp-server，命令如下：

npx -y @smithery/cli install @yiGmMk/mcp-server --client claude

前置依賴

• Python 3.12 或更高版本
• uv 包管理器

若尚未安裝 uv，可參考文檔uv 安裝文檔。不同系統的安裝命令如下：

• macOS 或 Linux：

curl -LsSf https://astral.sh/uv/install.sh | sh

• Windows 系統：在 PowerShell 中運行

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

配置文件

有兩種配置方式可供選擇，優先使用以下配置：

{
    "mcpServers": {
        "yiGmMk/mcp-server": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/your/mcp-server",
                "run",
                "main.py"
            ],
            "env": {
                "JINA_API_KEY": "jina_api_key，請從https://jina.ai/reader獲取",
                "PYTHONIOENCODING": "utf-8"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

也可使用 venv（增加環境變量配置）：

{
    "mcpServers": {
        "yiGmMk/mcp-server": {
            "command": "uv",
            "args": [
                "run",
                "/path/to/your/mcp-server/main.py"
            ],
            "env": {
                "VIRTUAL_ENV": "/path/to/your/mcp-server/.venv",
                "JINA_API_KEY": "jina_api_key，請從https://jina.ai/reader獲取",
                "PYTHONIOENCODING": "utf-8"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

📚 詳細文檔

jina.ai 提供了各種工具，如搜索、網頁讀取等。

📄 待辦事項

• [ ] 發佈到 https://smithery.ai/server/@yiGmMk/mcp-server/tools
  Docker 容器中運行 mcp 服務後立即退出，導致無法使用。相關問題：
  1. MCP within a Docker Container exits, regardless of lifespan
  2. ifespan shuts as soon as it opens