使用说明
MCP服务器集合
此存储库包含一组MCP(模型控制协议)服务器,旨在与Cursor IDE无缝协作。每台服务器都提供一项特定的服务,您可以通过在Cursor中与LLM发起聊天来访问该服务。以下是一个快速概述:
- SQLite数据库服务器: 管理和查询SQLite数据库。
- Twilio短信服务器: 使用Twilio发送短信和验证电话号码。
- 重新发送电子邮件服务器: 通过重新发送服务发送电子邮件。
- DigitalOcean功能部署器: 将Python函数部署到DigitalOcean。
光标设置
开始之前,在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/
安装说明:
- 导航到服务器目录:
cd mcp_sqlite_server - 创建虚拟环境并激活它:
python -m venv venv source venv/bin/activate - 从其自身安装依赖项
requirements.txt:pip install -r requirements.txt
工作原理:
使用此服务器,您现在可以在Cursor中与您的LLM发起聊天,并要求它与您的SQLite数据库进行交互。例如,你可以说:
- LLM,获取年龄超过25岁的所有用户
- LLM,连接到数据库并向我显示用户表
这些请求被转换为查询SQLite数据库的MCP调用。
2.Twilio短信服务器
地点: mcp_sms_server_twilio/
安装说明:
- 导航到服务器目录:
cd mcp_sms_server_twilio - 创建并激活虚拟环境:
python -m venv venv source venv/bin/activate - 使用服务器自己的依赖项安装依赖项
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是否有效吗?”
这些请求被转换为触发Twilio SMS服务器的MCP呼叫。
3.重新发送电子邮件服务器
地点: mcp_email_server_resend/
安装说明:
- 导航到服务器目录:
cd mcp_email_server_resend - 设置并激活虚拟环境:
python -m venv venv source venv/bin/activate - 使用其自己的依赖项安装依赖项
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发送电子邮件。例如,你可以说:
- “法学硕士,发送一封主题为‘来自MCP的你好’和正文为‘这是一封测试电子邮件’的电子邮件。”
LLM将您的请求转换为MCP调用,以触发电子邮件服务器。
4.数字海洋功能部署器
地点: mcp_deploy_function_server_digitalocean/
先决条件:
- 安装
doctlCLI。 - 使用进行身份验证
doctl auth init.
安装说明:
- 导航到目录:
cd mcp_deploy_function_server_digitalocean - 设置并激活虚拟环境:
python -m venv venv source venv/bin/activate - 从服务器安装依赖项
requirements.txt:pip install -r requirements.txt
工作原理:
此服务器帮助您将Python函数部署到DigitalOcean。您可以在Cursor中与LLM交互以部署功能。例如,你可以说:
- “LLM,在'my-app'命名空间中从path/to/your/function.py部署我的函数。”
- LLM,将一个具有依赖项numpy和pandas的函数部署到区域nyc1
LLM将这些命令转换为MCP调用来处理部署。
运行服务器
虽然Cursor将根据您的配置自动启动服务器,但您也可以手动测试它们:
- 打开终端并导航到服务器的目录。
- 激活相应的虚拟环境。
- 运行服务器:例如:
python server-file.pypython sqlite-server.py对于SQLite服务器。python twilio-server.pyTwilio短信服务器。python resend-server.py用于重新发送电子邮件服务器。python do_function_deployer.pyDigitalOcean功能部署器。
最佳实践
-
虚拟环境和依赖关系:
每台服务器都有自己的requirements.txt文件,使您可以轻松安装所需的依赖项。命令在mcp.json指向该服务器虚拟环境中的Python可执行文件,确保MCP可以访问所有必要的库。如果愿意,您可以将依赖项组合到一个文件中,并为所有服务器使用单个虚拟环境,但建议使用单独的方法以实现更好的隔离。 -
环境变量:
将您的敏感数据保存在.env文件,避免将其提交到您的存储库。 -
测试:
在生产环境中使用这些服务器之前,请务必测试您的连接。 -
绝对路径:
确保所有路径~/.cursor/mcp.json是正确和绝对的。
错误处理
每台服务器都包含错误处理功能,以便在出现问题时返回清晰、描述性的消息。在Cursor中,您可以捕获异常并检查错误消息,以快速解决任何问题。
贡献
欢迎投稿!请随意:
- 添加新的MCP服务器。
- 增强现有功能。
- 改进文档。
许可证
MIT许可证-在您自己的项目中使用此项目,不受任何限制。