AI导哈

MCP服务器

一个使用Python SDK和UV依赖管理工具搭建的模型上下文协议（MCP）服务器，适用于本地开发和测试。

  • by SivakumarBalu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 sivakumarbalu/mcp-server-stickynotes

使用说明

带UV的MCP服务器

本项目演示了如何使用官方Python SDK设置和运行模型上下文协议（MCP）服务器，并使用UV进行依赖管理。

先决条件

  • Python 3.8或更高版本
  • 紫外线的 -一个快速的Python包安装程序和解析器

安装

  1. 安装UV （如果尚未安装）：

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

    或者通过pip安装（如果你已经有Python）：

    pip install uv

  2. 初始化新的UV项目 （如果从头开始）：

    uv init mcp-server-custom
cd mcp-server-custom

  3. 使用CLI工具添加MCP SDK:

    uv add "mcp[cli]"

项目结构

mcp-server-custom/
├── main.py          # Your MCP server implementation
├── pyproject.toml   # Project configuration (created by UV)
└── README.md        # This file

创建MCP服务器

创建一个 main.py 文件中包含您的MCP服务器实现。以下是一个基本示例：

# main.py
from mcp.server.fastmcp import FastMCP

# Create an MCP server instance
mcp = FastMCP("MyCustomServer")

# Add a simple tool
@mcp.tool()
def greet(name: str) -> str:
    """Generate a greeting for the given name."""
    return f"Hello, {name}! Welcome to the MCP server."

# Add a resource
@mcp.resource("info://{item}")
def get_info(item: str) -> str:
    """Get information about an item."""
    return f"Information about {item}: This is a sample MCP resource."

运行服务器

发展模式

要在热重新加载的开发模式下运行服务器，请执行以下操作：

uv run mcp dev main.py

这将启动MCP服务器，并使其可用于本地开发。

生产模式

对于生产使用，您可以直接运行服务器：

uv run python main.py

测试您的MCP服务器

使用MCP检查器测试您的服务器：

uv run mcp dev main.py

这将在以下时间启动MCP检查器 http://localhost:8000 在那里你可以测试你的工具和资源。

与Claude Desktop一起使用

如果您安装了Claude Desktop，则可以直接安装MCP服务器：

uv run mcp install main.py

高级配置

环境变量

您可以使用以下环境变量配置服务器：

  • MCP_HOST：要绑定的主机（默认值：0.0.0.0）
  • MCP_PORT：要侦听的端口（默认值：8000）
  • MCP_LOG_LEVEL：日志记录级别（默认值：info）

依赖项

要向项目添加其他依赖项，请执行以下操作：

uv add package-name

故障排除

  • 未找到UV：确保UV已安装并位于PATH中
  • 依赖性问题：尝试重新创建虚拟环境：
    rm -rf .venv
uv venv
uv pip install -e .

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP