MCP Server 95i

🚀 mcp-server

Learn to write an mcp server.

🚀 Quick Start

✨ Features

This project is for learning to write an mcp server, and it provides an installation guide and configuration information.

📦 Installation

Install via Smithery

Automatically install the mcp-server for Claude Desktop through Smithery:

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

Prerequisites

• Python 3.12 or higher
• uv package manager

If you haven't installed uv yet, please refer to the uv Installation Documentation.

On macOS or Linux, you can use the following command to install:

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

On Windows, run the following command in PowerShell:

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

Configuration Files

It is recommended to use the following configuration method:

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

Or use venv (with additional environment variable configuration):

{
    "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, please obtain it from https://jina.ai/reader",
                "PYTHONIOENCODING": "utf-8"
            },
            "disabled": false,
            "autoApprove": []
        }
    }
}

📚 Documentation

jina.ai

jina.ai provides various tools, such as search and web page reading.

📄 TODO

• [ ] Publish to https://smithery.ai/server/@yiGmMk/mcp-server/tools
  The mcp service exits immediately after running in a Docker container, making it unavailable. Related issues:
  1. MCP within a Docker Container exits, regardless of lifespan
  2. ifespan shuts as soon as it opens