黄砖MCP服务器
Yellowbrick MCP Server提供了一个无缝的界面,可以使用自然语言查询Yellowbrick数据库,并提供由OpenAI嵌入支持的可选文档搜索。
______________________________________________________________________
目录
______________________________________________________________________
入门指南
- 设置环境变量:
- YELLOWBRICK_CONNECTION (您的Yellowbrick DB连接字符串)
OPENAI_API_KEY(文档搜索需要)EMBEDDING_TABLE(可选,用于矢量文档搜索)
- 构建Docker镜像:
source build.src______________________________________________________________________
与克劳德一起跑步
- 按照上述步骤构建Docker镜像。
- 将以下段添加到您的Claude配置中:
/Users/[Your Username]/Library/Application Support/Claude/claude_desktop_config.json
{
"globalShortcut": "",
"mcpServers": {
"Yellowbrick": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "YELLOWBRICK_CONNECTION",
"-e", "OPENAI_API_KEY",
"-e", "EMBEDDING_TABLE",
"ybmcp"
],
"env": {
"YELLOWBRICK_CONNECTION": "postgresql://[user]:[pwd]@[host]:[port]/[dbname]",
"OPENAI_API_KEY": "sk-XXXXXXXXX",
"EMBEDDING_TABLE": "my_embeddings"
}
}
}
}- 重启克劳德。
- 如果您已加载PremDB模式(来自示例),请尝试以下查询:
- “有多少场比赛以平局告终?” - “每支球队的输赢记录是什么?” - “描述一下比赛桌?” - “团队表中有多少行?”
______________________________________________________________________
使用VS代码运行
- 按
CMD+SHIFT+P,类型MCP: Add,并选择stdio.
- 输入以下命令(用您的凭据替换占位符):
docker run -i --rm \
-e YELLOWBRICK_CONNECTION=postgresql://[user]:[pwd]@[host]:[port]/[dbname] \
-e OPENAI_API_KEY=sk-XXXXXXXX \
-e EMBEDDING_TABLE=mcpvdb2 \
-e READ_ONLY=true \
ybmcp______________________________________________________________________
配置
- 黄砖连接:您的Yellowbrick PostgreSQL连接字符串。
- OPENAI_API密钥:您的OpenAI API密钥(用于文档搜索)。
- 嵌入表:向量嵌入表的名称(可选)。
- 只读:设置为
true(默认)禁用写入操作(INSERT、UPDATE、DELETE等)以确保安全。吃起来false以允许写查询。
______________________________________________________________________
示例问题
如果您已加载PremDB模式(来自示例),请尝试以下查询:
- “有多少场比赛以平局告终?”
- “每支球队的输赢记录是什么?”
- “描述一下比赛桌?”
- “团队表中有多少行?”
______________________________________________________________________
有关更多详细信息,请参阅中的评论 mcp.json 以及Dockerfile。
