🧠 使用 uv、llama-index、ollama 和 Cursor IDE 进行高级 MCP 服务器设置

---

✅ 前提条件

• [x] 已安装 Python 3.10+
• [x] 已全局安装 uv (by Astral) (pip install uv)
• [x] 已安装并在本地运行 Ollama
• [x] 已安装 Cursor IDE

---

🛠 第 1 步：项目设置

1.1 创建新项目目录

uv init mcp-server
cd mcp-server

1.2 创建并激活虚拟环境

uv venv
.venv\Scripts\activate  # 在 Windows 上
# 或者
source .venv/bin/activate  # 在 Linux/Mac 上

---

🔐 第 2 步：环境配置

在项目根目录中创建一个 .env 文件，并添加您的 API 密钥：

LINKUP_API_KEY=your_api_key_here

---

📦 第 3 步：安装所需依赖项

在您的虚拟环境中逐个运行以下命令：

# 核心 MCP CLI 和 HTTP 实用程序
uv add mcp[cli] httpx

# 用于编排代理的 Linkup SDK
uv add linkup-sdk

# LlamaIndex 集成
uv add llama-index
uv add llama-index-embeddings-huggingface
uv add llama-index-llms-ollama

# 可选：用于使用笔记本
uv add ipykernel

---

🧪 第 4 步：确认安装

安装后，检查您的 uv 管理的 pyproject.toml 文件，看是否包含如下内容：

[tool.uv.dependencies]
mcp = { extras = ["cli"] }
httpx = "*"
linkup-sdk = "*"
llama-index = "*"
llama-index-embeddings-huggingface = "*"
llama-index-llms-ollama = "*"
ipykernel = "*"

---

⚙️ 第 5 步：创建一个最小的服务器入口点

在项目根目录中创建一个 server.py 文件：

# server.py

from mcp.cli import app

if __name__ == "__main__":
    app()

您稍后可以用您自己的 FastMCP 或 Agent orchestrator 脚本替换它。

---

🧠 第 6 步：在本地运行 Ollama

确保已安装并运行 Ollama：

ollama run llama3.2 Or any model you want

这将在 http://localhost:11434 启动 LLM 后端。

---

🖥️ 第 7 步：在 Cursor IDE 中配置 MCP 服务器

7.1 打开 Cursor 设置

• 打开 Settings → 转到 MCP 部分。
• 点击 "Add New Global MCP Server"

7.2 填写配置

将路径替换为您实际的机器路径。 您可以通过运行以下命令获取 uv 的完整路径：

where uv  # Windows

现在将其添加到您的 Cursor IDE 设置中：

{
  "mcpServers": {
    "weather": {
      "command": "C:\\Users\\SIDHYA\\AppData\\Roaming\\Python\\Python311\\Scripts\\uv.exe",  // 替换为您实际的 uv 路径
      "args": [
        "--directory",
        "C:\\Users\\SIDHYA\\Development\\Ai\\mcp-server",
        "run",
        "server.py"
      ]
    }
  }
}

---

🧪 第 8 步：测试集成

1. 在 Cursor 中打开任何 .py 文件。
2. 使用 MCP 工具（通常可以通过 ⌘K 或 Ctrl+K 访问）来运行 “weather” MCP 服务器。
3. 您应该看到服务器使用您的 server.py 启动。

---

📘 建议的目录结构

mcp-server/
├── .env
├── pyproject.toml
├── server.py
└── rag.py

---

🔁 保持更新

要更新依赖项：

uv pip install --upgrade llama-index
uv pip install --upgrade linkup-sdk

---

✍️ 作者

👋 嗨，我是 Asutosh Sidhya

🌐 与我联系

• 📧 电子邮件：sidhyaasutosh@gmail.com
• 🧑‍💻 GitHub：@asutosh7
• 💼 LinkedIn：linkedin.com/in/asutosh-sidhya

如果您正在构建与 AI 代理、本地 LLM 或自动化 RAG 管道相关的东西，我很乐意联系或合作！