## Baidu Map MCP Server (Python)
### 搭建Python虚拟环境
我们推荐通过`uv`构建虚拟环境来运行MCP server，关于`uv你可以在[这里](https://docs.astral.sh/uv/getting-started/features/)找到一些说明。
按照[官方流程](https://modelcontextprotocol.io/quickstart/server)，你会安装`Python`包管理工具`uv`。除此之外，你也可以尝试其他方法（如`Anaconda`）来创建你的`Python`虚拟环境。
通过`uv`添加`mcp`依赖
```bash
uv add "mcp[cli]"
```
验证mcp依赖是否安装成功，执行如下命令
```bash
uv run mcp
```
当出现下图时代表安装成功
通过`uv`安装`python`，最低版本要求为3.11
```bash
uv python install 3.11
```
### 获取 MCP Server
前往百度地图 Mcp Server 官方[开源仓库](https://github.com/baidu-maps/mcp/tree/main/src/baidu-map/python)下载
### 配置本地项目
通过`uv`创建一个项目
```bash
uv init mcp_server_baidu_maps
```
将`map.py`拷贝到该目录下，通过如下命令测试mcp server是否正常运行
```bash
uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
# 如果是mac，需要加转义符
uv run --with mcp\[cli\] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
```
如果没有报错则MCP Server启动成功
### 在Cursor中使用
打开`Cursor`配置，在MCP中添加MCP Server
在文件中添加如下内容后保存
```json
{
"mcpServers": {
"baidu-map": {
"command": "uv",
"args": [
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"{YOUR_PATH}/mcp_server_baidu_maps/map.py"
],
"env": {
"BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
```
回到配置，此时百度MCP Server已经启用
### 测试
行程规划：
Raw data
{
"_id": null,
"home_page": null,
"name": "mcp-server-baidu-maps",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": "Pineapple274 <yuyangyang3838@gmail.com>",
"keywords": "http, mcp, map, baidu",
"author": "baidu-maps",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/f2/a2/788e6bdc182fdf838d167d7a7d8a2d008e80edb3a72074a2d7835b7cbab5/mcp_server_baidu_maps-0.2.2.tar.gz",
"platform": null,
"description": "## Baidu Map MCP Server (Python)\n### \u642d\u5efaPython\u865a\u62df\u73af\u5883\n\u6211\u4eec\u63a8\u8350\u901a\u8fc7`uv`\u6784\u5efa\u865a\u62df\u73af\u5883\u6765\u8fd0\u884cMCP server\uff0c\u5173\u4e8e`uv\u4f60\u53ef\u4ee5\u5728[\u8fd9\u91cc](https://docs.astral.sh/uv/getting-started/features/)\u627e\u5230\u4e00\u4e9b\u8bf4\u660e\u3002\n\n\u6309\u7167[\u5b98\u65b9\u6d41\u7a0b](https://modelcontextprotocol.io/quickstart/server)\uff0c\u4f60\u4f1a\u5b89\u88c5`Python`\u5305\u7ba1\u7406\u5de5\u5177`uv`\u3002\u9664\u6b64\u4e4b\u5916\uff0c\u4f60\u4e5f\u53ef\u4ee5\u5c1d\u8bd5\u5176\u4ed6\u65b9\u6cd5\uff08\u5982`Anaconda`\uff09\u6765\u521b\u5efa\u4f60\u7684`Python`\u865a\u62df\u73af\u5883\u3002\n\n\u901a\u8fc7`uv`\u6dfb\u52a0`mcp`\u4f9d\u8d56\n\n```bash\nuv add \"mcp[cli]\"\n```\n\n\u9a8c\u8bc1mcp\u4f9d\u8d56\u662f\u5426\u5b89\u88c5\u6210\u529f\uff0c\u6267\u884c\u5982\u4e0b\u547d\u4ee4\n```bash\nuv run mcp\n```\n\n\u5f53\u51fa\u73b0\u4e0b\u56fe\u65f6\u4ee3\u8868\u5b89\u88c5\u6210\u529f\n\n\n\n\u901a\u8fc7`uv`\u5b89\u88c5`python`\uff0c\u6700\u4f4e\u7248\u672c\u8981\u6c42\u4e3a3.11\n\n```bash\nuv python install 3.11\n```\n\n### \u83b7\u53d6 MCP Server\n\u524d\u5f80\u767e\u5ea6\u5730\u56fe Mcp Server \u5b98\u65b9[\u5f00\u6e90\u4ed3\u5e93](https://github.com/baidu-maps/mcp/tree/main/src/baidu-map/python)\u4e0b\u8f7d\n\n### \u914d\u7f6e\u672c\u5730\u9879\u76ee\n\u901a\u8fc7`uv`\u521b\u5efa\u4e00\u4e2a\u9879\u76ee\n\n```bash\nuv init mcp_server_baidu_maps\n```\n\n\u5c06`map.py`\u62f7\u8d1d\u5230\u8be5\u76ee\u5f55\u4e0b\uff0c\u901a\u8fc7\u5982\u4e0b\u547d\u4ee4\u6d4b\u8bd5mcp server\u662f\u5426\u6b63\u5e38\u8fd0\u884c\n\n```bash\nuv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py\n# \u5982\u679c\u662fmac\uff0c\u9700\u8981\u52a0\u8f6c\u4e49\u7b26\nuv run --with mcp\\[cli\\] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py\n```\n\n\u5982\u679c\u6ca1\u6709\u62a5\u9519\u5219MCP Server\u542f\u52a8\u6210\u529f\n\n### \u5728Cursor\u4e2d\u4f7f\u7528\n\n\u6253\u5f00`Cursor`\u914d\u7f6e\uff0c\u5728MCP\u4e2d\u6dfb\u52a0MCP Server\n\n\n\n\u5728\u6587\u4ef6\u4e2d\u6dfb\u52a0\u5982\u4e0b\u5185\u5bb9\u540e\u4fdd\u5b58\n\n```json\n{\n \"mcpServers\": {\n \"baidu-map\": {\n \"command\": \"uv\",\n \"args\": [\n \"run\",\n \"--with\",\n \"mcp[cli]\",\n \"mcp\",\n \"run\",\n \"{YOUR_PATH}/mcp_server_baidu_maps/map.py\"\n ],\n \"env\": {\n \"BAIDU_MAPS_API_KEY\": \"<YOUR_API_KEY>\"\n }\n }\n }\n}\n```\n\n\u56de\u5230\u914d\u7f6e\uff0c\u6b64\u65f6\u767e\u5ea6MCP Server\u5df2\u7ecf\u542f\u7528\n\n\n\n### \u6d4b\u8bd5\n\n\u884c\u7a0b\u89c4\u5212\uff1a\n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "MCP Server Baidu Maps",
"version": "0.2.2",
"project_urls": null,
"split_keywords": [
"http",
" mcp",
" map",
" baidu"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "d5636d3a80fe04e02321f880ab47df5b89c4d2b3d0d61bcaf09c25544ee42a53",
"md5": "9ae03655c83a8e40eabd77059d7e2d41",
"sha256": "99f33ad035557b0edd6d4973dd95e526cfaa936b869c9559e8276c36b8b40e14"
},
"downloads": -1,
"filename": "mcp_server_baidu_maps-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9ae03655c83a8e40eabd77059d7e2d41",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 11062,
"upload_time": "2025-07-11T04:51:24",
"upload_time_iso_8601": "2025-07-11T04:51:24.604012Z",
"url": "https://files.pythonhosted.org/packages/d5/63/6d3a80fe04e02321f880ab47df5b89c4d2b3d0d61bcaf09c25544ee42a53/mcp_server_baidu_maps-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f2a2788e6bdc182fdf838d167d7a7d8a2d008e80edb3a72074a2d7835b7cbab5",
"md5": "d2be57ad529ed3bf88818f8072c9d65b",
"sha256": "86c4a5449e8b01efa45ad25e246bd2fba616c003e902a89037828661a9024982"
},
"downloads": -1,
"filename": "mcp_server_baidu_maps-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "d2be57ad529ed3bf88818f8072c9d65b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 11476,
"upload_time": "2025-07-11T04:51:26",
"upload_time_iso_8601": "2025-07-11T04:51:26.332564Z",
"url": "https://files.pythonhosted.org/packages/f2/a2/788e6bdc182fdf838d167d7a7d8a2d008e80edb3a72074a2d7835b7cbab5/mcp_server_baidu_maps-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-11 04:51:26",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "mcp-server-baidu-maps"
}
JSON