pdal MCP

掌上电脑mcp

PDAL MCP是一个开源服务器，它公开了常见的 掌上电脑 命令行实用程序通过 模型上下文协议（MCP）.PDAL是一个C++库，用于读取和处理激光雷达等点云数据，类似于光栅和矢量数据的GDAL【213350811818443†L146-L162】。MCP规范了AI代理如何通过JSON-RPC调用外部工具，强调安全、可发现和上下文保持操作【922541277255947†L51-L66】【922541277 255947？L132-L152】。该项目将PDAL的CLI命令打包为MCP工具，以便AI助手可以在受控环境中检查、翻译和处理点云数据。

特性

• 为关键的PDAL命令提供MCP工具定义： info, translate, pipeline, merge, split, tile 和 tindex.
• 通过JSON模式验证输入，并防止在配置的工作目录之外进行访问。
• 生成结构化输出（JSON或文件资源），便于AI代理使用。
• 可通过JSON文件和环境变量进行配置。
• 设计为开源和可扩展的——贡献者可以添加更多的PDAL工具。

有关每个工具的架构细节和JSON模式，请参阅 pdal_mcpdesign.md.

安装

先决条件

• Python 3.9+.
• 掌上电脑 安装在主机系统上（确保 pdal CLI可在您的 PATH).您可以通过conda安装PDAL：

conda install -c conda-forge pdal

• 克隆此存储库：

git clone https://github.com/JordanGunn/pdal-mcp.git
cd pdal-mcp

安装依赖项

• 推荐：使用 uv 管理本地Python环境并安装MCP Python SDK和PDAL绑定：

uv init  # initialise a uv project (skip if already in a uv-managed directory)
uv add "mcp[cli]" pdal

• 或者，通过pip安装：

python3 -m pip install "mcp[cli]" pdal

运行服务器

本项目使用MCP Python SDK FastMCP 服务器。创建配置文件（见下文）后，您可以使用以下命令运行服务器 uv:

# Copy the example config and edit as needed
cp config.example.json config.json

# Point the environment variable to your config
export PDAL_MCP_CONFIG=$(pwd)/config.json

# Start the MCP server in development mode with hot‑reloading
uv run mcp dev src/server.py

# Start the MCP server via stdio (useful for production)
uv run mcp src/server.py stdio

注： 一些MCP服务器通过Node分布(npx)或生锈(uvx)，但该项目使用官方Python SDK和 uv 用于依赖性管理和执行。

配置

服务器从JSON文件读取配置。在中设置文件的路径 PDAL_MCP_CONFIG 启动服务器之前的环境变量。典型的配置如下：

{
  "workdir": "/srv/pdal_mcp/workdir",
  "allowedCommands": ["info","translate","pipeline","merge","split","tile","tindex"],
  "maxTimeout": 60000,
  "port": 3001
}

• 工作目录 –存储输入和输出文件的目录。服务器拒绝此文件夹之外的路径。
• 允许的命令 –服务器上启用的PDAL命令列表。
• 最大超时 –任何命令的最大运行时间（ms）。
• 端口 –通过uv启动服务器时要绑定的端口。

MCP工具

有关每个工具的输入和输出JSON模式，请参阅设计文档。

示例用法

在端口上启动服务器后 3001，您可以通过JSON-RPC调用MCP方法：

列出可用工具：

curl -X POST http://localhost:3001/mcp/tools/list \
 -H "Content-Type: application/json" \
 -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

呼叫 pdal_info 在工作目录中的文件上：

curl -X POST http://localhost:3001/mcp/calls \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "jsonrpc": "2.0",
  "method": "pdal_info",
  "params": {
    "inputFile": "data.las",
    "all": true
  },
  "id": 1
}
EOF

贡献

C欢迎投稿！请看 贡献.md 有关如何报告问题的指导方针，请向此项目提出新功能并添加新的PDAL工具。

行为准则

该项目遵循 行为准则。通过参与，您将遵守此准则。

许可证

该项目根据 MIT许可证.

致谢

• 掌上电脑 以及它的开发者。
• 模型上下文协议 社区定义MCP规范。