AI导哈

MCP服务器示例

一个使用FastMCP实现的最小化MCP服务器示例，展示如何克隆项目、安装依赖、启动服务器并将其添加到VS Code中。

  • by luskbo
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 luskbo/mcpserverdemo

使用说明

MCP服务器演示——快速入门

此存储库是使用FastMCP实现的MCP服务器的最小示例。 下面的说明显示了如何从GitHub克隆项目，安装 uv 项目经理，使用 uv sync 要安装依赖项，请启动服务器，并将服务器作为MCP服务器添加到VS Code中。

先决条件

  • macOS（指令使用zsh）。根据需要调整其他操作系统。
  • Python 3.11+（项目 pyproject.toml 请求Python>=3.11）。
  1. 从GitHub克隆项目

使用存储库页面中的首选克隆URL。示例（HTTPS）：

git clone https://github.com/<owner>/mcpserverdemo.git
cd mcpserverdemo

或者使用SSH：

git clone git@github.com:<owner>/mcpserverdemo.git
cd mcpserverdemo
  1. 安装紫外线（星光紫外线）

uv是推荐的项目经理 mcp 包和这个项目。最简单的安装方法是使用官方安装程序：

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

安装后，确保uv二进制文件在PATH上。共同位置（将此添加到您的 ~/.zshrc 如果需要）：

export PATH="$HOME/.local/bin:$PATH"
# then reload your shell
source ~/.zshrc

替代安装方法（Homebrew、pip等）记录在https://docs.astral.sh/uv/getting-started/installation/.

验证安装：

which uv
uv --version

Get-Command uv | Select-Object Source
  1. 使用uv同步安装依赖项

此存储库包括 uv.lock 文件。 使用 uv sync 将锁定的依赖项安装到项目虚拟环境中（通常 .venv):

cd /path/to/mcpserverdemo
uv sync

uv sync 读取锁文件并安装确切的软件包。 如果需要更新或重新生成锁文件，请参阅 uv lock 在uv文档中。

  1. 启动MCP服务器

有几种方法可以运行示例服务器。 最简单的方法是在uv管理的环境中运行脚本，这样依赖关系就会自动可用。

直接通过uv运行服务器脚本：

uv run --directory . mcp_server.py

或者使用 mcp 助手由 mcp package（package提供的一些示例用法）：

# development mode (example)
uv run mcp dev mcp_server.py

# run the mcp CLI (shows available commands)
uv run mcp --help

作为后备方案，您可以激活创建的 .venv 并用Python运行脚本：

source .venv/bin/activate
python mcp_server.py
  1. 在VS Code中将服务器添加为MCP服务器

您可以通过创建 mcp.json 输入您的工作区或用户设置。 将文件放置在您的工作区中（推荐） .vscode/mcp.json 有这样的内容（更新 command 通往现实的道路 uv 系统上的二进制文件）：

我通常只在VSCode LLM客户端的代理模式下使用添加工具按钮。

{
  "servers": {
    "mcpserverdemo-local": {
      "type": "stdio",
      "command": "/Users/youruser/.local/bin/uv",
      "args": [
        "run",
        "--directory",
        "${workspaceFolder}",
        "mcp_server.py"
      ]
    }
  },
  "inputs": []
}

笔记：

  • 替换 /Users/youruser/.local/bin/uv 与路径从 which uv 在你的机器上。
  • 使用 uv run 调用确保脚本在正确的项目环境中运行，并从中获取依赖关系 .venv.
  • 如果希望服务器跨工作区可用，您还可以将相同的条目添加到全局VS Code MCP用户设置中（VS Code用户数据中显示的路径）。
  1. 故障排除和提示
  • 如果 uv 安装后找不到bin目录，请确保安装程序已将bin目录添加到PATH中（常见位置： ~/.local/bin, /usr/local/bin).
  • 如果服务器未启动，请检查 .venv 存在并且 uv sync 已完成，没有错误。激活 .venv 并尝试 python mcp_server.py 查看Python异常。
  • 这 mcp 软件包建议使用 uv 并提供辅助命令；跑 uv run mcp --help 探索以下命令 mcp dev, mcp install以及其他。

更多信息

  • 紫外线文件：https://docs.astral.sh/uv/
  • MCP规范和示例：https://modelcontextprotocol.io/
  • FastMCP：https://github.com/modelcontextprotocol/fastmcp

如果你愿意，我也可以：

  • 添加一个 .vscode/mcp.json 将文件与示例条目（我可以创建它指向 uv 假设是典型的macOS安装位置），或
  • 添加一个简单的shell脚本 start.sh 运行 uv sync && uv run --directory . mcp_server.py 并使其可执行。

完成：README更新了uv+VS代码MCP说明。

相关 MCP