MCP建设计划
一个最小列表模型上下文协议MCP服务器，用于与数据表交互并运行Bauplan查询。
Bauplan在S3中管理冰山表的数据存储。
特性
- 在配置的命名空间中获取Bauplan数据表及其模式
- 使用SQL查询Bauplan数据表（仅限SELECT）
它支持SSE和STDIO传输。
工具
服务器实现了以下工具来与Bauplan数据表交互：
list_tables:
- 列出配置的命名空间中的所有表
get_schema:
- 获取数据表的架构
run_query:
- 在指定表上运行SELECT查询
配置
- 创建或编辑位于以下位置的Claude Desktop配置文件：
- 在macOS上： ~/Library/Application Support/Claude/claude_desktop_config.json - 在Windows上： %APPDATA%/Claude/claude_desktop_config.json
- 添加以下内容：
{
"mcpServers": {
"mcp-bauplan": {
"command": "/path/to/uvx",
"args": ["mcp-bauplan"],
"env": {
"BAUPLAN_API_KEY": "your-api-key",
"BAUPLAN_BRANCH": "your-branch",
"BAUPLAN_NAMESPACE": "your-namespace",
// Optional
"BAUPLAN_TIMEOUT": "query-timeout-secs" // default 30 seconds
}
}
}
}- 替换
/path/to/uvx通过绝对路径uvx可执行。找到路径which uvx在终端中执行命令。这确保了正确的版本uvx启动服务器时使用。
- 重新启动Claude Desktop以应用更改。
运行独立的SSE服务器
从.env.example创建.env文件，然后执行以下命令：
$ uvx --env-file /path/to/.env mcp-bauplan --transport sse --port 9090注意使用nvx而不是uvx将取回mcp-bauplan从默认注册表https://pypi.org.
未来发展
开发-正在进行中
- Bauplan（SDK和平台）作为资源的文档
- Bauplan执行自动化-更多命令和运行流水线
- 查询生成
- 使用模板生成代码
- 数据治理与合规
- 测试与验证
- 一体化生态系统
设置
- 先决条件:
- Python 3.10或更高版本。 - A Bauplanneneneba API密钥(在这里请求). - uv 包管理器(安装).
- 克隆存储库:
git clone https://github.com/marcoeg/mcp-bauplan
cd mcp-nvd- 设置环境变量:
- 创建一个 .env 项目根目录中的文件：
BAUPLAN_API_KEY=your-api-key
BAUPLAN_BRANCH=your-branch
BAUPLAN_NAMESPACE=your-namespace- 再进行:
uv sync
uv pip install -e .使用MCP检查器运行
cd /path/to/the/repo
source .env
CLIENT_PORT=8077 SERVER_PORT=8078 npx @modelcontextprotocol/inspector \
uv run mcp-bauplan注：省略 CLIENT_PORT=8077 SERVER_PORT=8078 如果标准端口没有冲突。然后打开浏览器到MCP检查器指示的URL，通常 http://localhost:8077?proxyPort=8078
在以下之间自由切换stdio和sse检查员中的运输类型。使用sse您需要按照以下说明运行服务器。
使用SSE传输进行测试
运行服务器：
cd /path/to/the/repo
source .env
uv run mcp-bauplan --transport sse --port 9090- 在港口使用SSE运输
9090默认情况下。
然后打开浏览器到MCP检查器指示的URL。选择SSE传输类型。