STARWARCLOUD STARWAR.AI
返回市场
MCP服务器

MCP服务器

作者：ajot5 星标更新：2025-04-03
安装使用来源：spider==github.com

项目介绍

MCP 服务器集合

此仓库包含一组设计用于与 Cursor IDE 无缝协作的 MCP（模型控制协议）服务器。每个服务器提供特定的服务，您可以通过在 Cursor 中与您的大语言模型（LLM）进行聊天来访问这些服务。以下是一个快速概述：

  • SQLite 数据库服务器： 管理和查询 SQLite 数据库。
  • Twilio 短信服务器： 使用 Twilio 发送短信并验证电话号码。
  • Resend 邮件服务器： 通过 Resend 服务发送电子邮件。
  • DigitalOcean 函数部署器： 将 Python 函数部署到 DigitalOcean。

Cursor 设置

在开始之前，请在 Cursor 中配置您的 MCP 服务器，方法是创建或更新 ~/.cursor/mcp.json 文件。以下是示例配置：

{
  "mcpServers": {
    "sqlite-server": {
      "command": "/path/to/mcp_servers/mcp_sqlite_server/venv/bin/python",
      "args": [
        "/path/to/mcp_servers/mcp_sqlite_server/sqlite-server.py",
        "--db-path",
        "/path/to/your/users.db"
      ]
    },
    "send-sms-twilio": {
      "command": "/path/to/mcp_servers/mcp_sms_server_twilio/venv/bin/python",
      "args": [
        "/path/to/mcp_servers/mcp_sms_server_twilio/twilio-server.py"
      ]
    },
    "send-email-resend": {
      "command": "/path/to/mcp_servers/mcp_email_server_resend/venv/bin/python",
      "args": [
        "/path/to/mcp_servers/mcp_email_server_resend/resend-server.py"
      ]
    },
    "do-function-deployer": {
      "command": "/path/to/mcp_servers/mcp_deploy_function_server_digitalocean/venv/bin/python",
      "args": [
        "/path/to/mcp_servers/mcp_deploy_function_server_digitalocean/do_function_deployer.py"
      ]
    }
  }
}

请注意：

  • 将 /path/to/ 替换为您实际的项目路径。
  • 为每个服务器创建虚拟环境。mcp.json 文件中的命令直接指向该虚拟环境中的 Python 可执行文件，确保 MCP 可以访问所有必需的依赖项。
  • 每个服务器都包括自己的 requirements.txt 文件，这使得安装所需的依赖项变得容易。（如果您愿意，可以将所有依赖项合并到一个文件中，并为所有服务器使用一个虚拟环境。）

可用服务器

1. SQLite 数据库服务器

位置： mcp_sqlite_server/

设置说明：

  1. 导航到服务器目录： 
    cd mcp_sqlite_server
  2. 创建并激活虚拟环境： 
    python -m venv venv
source venv/bin/activate
  3. 安装来自其自身的 requirements.txt 的依赖项： 
    pip install -r requirements.txt

工作原理： 通过这个服务器，您现在可以在 Cursor 中与您的 LLM 进行聊天，并请求它与您的 SQLite 数据库交互。例如，您可以这样说：

  • "LLM，获取年龄超过 25 岁的所有用户。"
  • "LLM，连接到数据库并显示用户表。" 这些请求被转换成 MCP 调用来查询您的 SQLite 数据库。

2. Twilio 短信服务器

位置： mcp_sms_server_twilio/

设置说明：

  1. 导航到服务器目录： 
    cd mcp_sms_server_twilio
  2. 创建并激活虚拟环境： 
    python -m venv venv
source venv/bin/activate
  3. 使用服务器自身的 requirements.txt 安装依赖项： 
    pip install -r requirements.txt

环境变量： 创建一个 .env 文件，其中包含您的 Twilio 凭证：

TWILIO_ACCOUNT_SID=your_account_sid
TWILIO_AUTH_TOKEN=your_auth_token
TWILIO_PHONE_FROM=your_twilio_phone
TWILIO_PHONE_TO=default_recipient_phone

工作原理： 此服务器允许您通过 Cursor 中的 LLM 交互发送短信并验证电话号码。例如，您可以这样说：

  • "LLM，发送一条短信说 '来自 MCP 的问候！'"
  • "LLM，你能检查一下电话号码 +1234567890 是否有效吗？" 这些请求被翻译成 MCP 调用来触发 Twilio 短信服务器。

3. Resend 邮件服务器

位置： mcp_email_server_resend/

设置说明：

  1. 导航到服务器目录： 
    cd mcp_email_server_resend
  2. 创建并激活虚拟环境： 
    python -m venv venv
source venv/bin/activate
  3. 使用其自身的 requirements.txt 安装依赖项： 
    pip install -r requirements.txt

环境变量： 创建一个 .env 文件，其中包含：

RESEND_API_KEY=your_resend_api_key
RESEND_EMAIL_FROM=your_verified_email
RESEND_EMAIL_TO=default_recipient_email

工作原理： 通过这个服务器，您可以在 Cursor 中指示您的 LLM 发送电子邮件。例如，您可以这样说：

  • "LLM，发送一封主题为 '来自 MCP 的问候'，正文为 '这是一封测试邮件。'" LLM 将您的请求转换为 MCP 调用来触发邮件服务器。

4. DigitalOcean 函数部署器

位置： mcp_deploy_function_server_digitalocean/

前提条件：

  • 安装 doctl CLI。
  • 使用 doctl auth init 进行身份验证。

设置说明：

  1. 导航到目录： 
    cd mcp_deploy_function_server_digitalocean
  2. 创建并激活虚拟环境： 
    python -m venv venv
source venv/bin/activate
  3. 使用服务器的 requirements.txt 安装依赖项： 
    pip install -r requirements.txt

工作原理： 此服务器帮助您将 Python 函数部署到 DigitalOcean。您可以在 Cursor 中与您的 LLM 交互以部署函数。例如，您可以这样说：

  • "LLM，从 path/to/your/function.py 部署我的函数到 'my-app' 命名空间。"
  • "LLM，部署带有 numpy 和 pandas 依赖项的函数到 nyc1 区域。" LLM 将这些命令翻译成 MCP 调用来处理部署。

运行服务器

虽然 Cursor 会根据您的配置自动启动服务器，但您也可以手动测试它们：

  1. 打开终端并导航到服务器目录。
  2. 激活相应的虚拟环境。
  3. 运行服务器： 
    python server-file.py
    例如：
    • 对于 SQLite 服务器：python sqlite-server.py
    • 对于 Twilio 短信服务器：python twilio-server.py
    • 对于 Resend 邮件服务器：python resend-server.py
    • 对于 DigitalOcean 函数部署器：python do_function_deployer.py

最佳实践

  • 虚拟环境与依赖项： 每个服务器都包括自己的 requirements.txt 文件，使得安装所需的依赖项变得容易。mcp.json 文件中的命令指向该服务器虚拟环境中的 Python 可执行文件，确保 MCP 可以访问所有必要的库。如果您愿意，可以将依赖项合并到一个文件中，并为所有服务器使用一个虚拟环境，但建议采用单独的方法以获得更好的隔离性。

  • 环境变量： 将敏感数据保存在 .env 文件中，并避免将其提交到您的仓库。

  • 测试： 在生产环境中使用这些服务器之前，请始终进行连接测试。

  • 绝对路径： 确保 ~/.cursor/mcp.json 中的所有路径都是正确的且为绝对路径。

错误处理

每个服务器都包含错误处理机制，以便在出现问题时返回清晰且描述性的消息。在 Cursor 中，您可以捕获异常并检查错误消息以迅速解决任何问题。

贡献

欢迎贡献！您可以自由地：

  • 添加新的 MCP 服务器。
  • 增强现有功能。
  • 改进文档。

许可

MIT 许可证——您可以无限制地在自己的项目中使用本项目。