mcp-server-95i

🚀 mcp-server

学习编写 mcp 服务器，助力你在相关领域的开发学习。通过本项目，你可以深入了解 mcp 服务器的搭建与使用。

🚀 快速开始

你可以通过以下步骤快速开启 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 提供了各种工具，如搜索、网页读取等，可进一步探索其功能。

📄 TODO

• [ ] 发布到 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