Puddle MCP

布丁MCP

Puddle的MCP（模型上下文协议）服务器。

设置

1.克隆存储库

git clone https://github.com/Dhruv-Limbani/puddle-mcp.git
cd puddle-mcp

2.安装uv（Python包和环境管理器）

如果你没有 uv 已安装，请按照 安装指南.

对于macOS/Linux：

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

3.安装依赖项

uv sync

这会自动在以下位置创建虚拟环境 .venv 并安装所有依赖项。

4.配置环境变量

创建一个 .env 项目根目录中的文件具有以下结构：

API_KEY=pud_mc9p0k2xL8q5vR3jN7wH2bY6tF4mG8nS1cD5eP9w
DATABASE_URL=postgresql+asyncpg://postgres:password@localhost:5432/puddle
GEMINI_API_KEY=your_gemini_api_key_here

环境变量：

• API_KEY：用于身份验证的API密钥（生成安全随机密钥）
• DATABASE_URL：带asyncpg驱动程序的PostgreSQL数据库URL
• GEMINI_API_KEY：人工智能功能的Google Gemini API密钥

5.激活虚拟环境（可选，用于手动工作）

source .venv/bin/activate

运行服务器

使用自动重新加载启动开发服务器

uvicorn server:app --reload --port 8002

使用MCP检查器测试连接和工具

npx @modelcontextprotocol/inspector