| Name | bach-baidu-maps JSON |
| Version |
1.0.2
JSON |
| download |
| home_page | None |
| Summary | MCP Server Baidu Maps Enhanced - HTTP call Baidu Map API for MCP |
| upload_time | 2025-10-11 14:03:11 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.11 |
| license | MIT |
| keywords |
mcp
map
baidu
baidu-maps
fastmcp
http
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
## Baidu Map MCP Server (Python)
### 🚀 快速启动（推荐）
#### 使用 UVX 一键启动
```bash
uvx bach-baidu-maps
```
#### 在 Cursor/Cherry Studio 中配置
```json
{
"mcpServers": {
"baidu-maps": {
"command": "uvx",
"args": ["bach-baidu-maps"],
"env": {
"BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
}
}
}
}
```
**包地址**: https://pypi.org/project/bach-baidu-maps/
---
### 传统方式：搭建 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/rongquanfeng/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": "bach-baidu-maps",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "mcp, map, baidu, baidu-maps, fastmcp, http",
"author": null,
"author_email": "bachstudio <bachstudio@example.com>",
"download_url": "https://files.pythonhosted.org/packages/8e/a7/d535742d4a980504477c1cce7cd825abe3ec0a1bd948024950c2be4e1713/bach_baidu_maps-1.0.2.tar.gz",
"platform": null,
"description": "## Baidu Map MCP Server (Python)\n\n### \ud83d\ude80 \u5feb\u901f\u542f\u52a8\uff08\u63a8\u8350\uff09\n\n#### \u4f7f\u7528 UVX \u4e00\u952e\u542f\u52a8\n\n```bash\nuvx bach-baidu-maps\n```\n\n#### \u5728 Cursor/Cherry Studio \u4e2d\u914d\u7f6e\n\n```json\n{\n \"mcpServers\": {\n \"baidu-maps\": {\n \"command\": \"uvx\",\n \"args\": [\"bach-baidu-maps\"],\n \"env\": {\n \"BAIDU_MAPS_API_KEY\": \"<YOUR_API_KEY>\"\n }\n }\n }\n}\n```\n\n**\u5305\u5730\u5740**: https://pypi.org/project/bach-baidu-maps/\n\n---\n\n### \u4f20\u7edf\u65b9\u5f0f\uff1a\u642d\u5efa Python \u865a\u62df\u73af\u5883\n\n\u6211\u4eec\u63a8\u8350\u901a\u8fc7`uv`\u6784\u5efa\u865a\u62df\u73af\u5883\u6765\u8fd0\u884c MCP 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\u8bc1 mcp \u4f9d\u8d56\u662f\u5426\u5b89\u88c5\u6210\u529f\uff0c\u6267\u884c\u5982\u4e0b\u547d\u4ee4\n\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\u4e3a 3.11\n\n```bash\nuv python install 3.11\n```\n\n### \u83b7\u53d6 MCP Server\n\n\u524d\u5f80\u767e\u5ea6\u5730\u56fe MCP Server [\u5f00\u6e90\u4ed3\u5e93](https://github.com/rongquanfeng/baidu-maps-mcp/tree/main/src/baidu-map/python)\u4e0b\u8f7d\n\n### \u914d\u7f6e\u672c\u5730\u9879\u76ee\n\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\u8bd5 mcp 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\u5219 MCP Server \u542f\u52a8\u6210\u529f\n\n### \u5728 Cursor \u4e2d\u4f7f\u7528\n\n\u6253\u5f00`Cursor`\u914d\u7f6e\uff0c\u5728 MCP \u4e2d\u6dfb\u52a0 MCP 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\u5ea6 MCP 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 Enhanced - HTTP call Baidu Map API for MCP",
"version": "1.0.2",
"project_urls": {
"Bug Reports": "https://github.com/BACH-AI-Tools/baidu-maps-mcp/issues",
"Homepage": "https://github.com/BACH-AI-Tools/baidu-maps-mcp",
"Repository": "https://github.com/BACH-AI-Tools/baidu-maps-mcp"
},
"split_keywords": [
"mcp",
" map",
" baidu",
" baidu-maps",
" fastmcp",
" http"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "14a78cf4f9feea5c90cd60132dd9d6562195a896691f44cd8fc317c730512f96",
"md5": "1260a58d214126f498cb6fc647643bb1",
"sha256": "938d9f35ddc970204d5b4ac53ccb8d1c712b014a1e3875a2af087144ca83b270"
},
"downloads": -1,
"filename": "bach_baidu_maps-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1260a58d214126f498cb6fc647643bb1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 11640,
"upload_time": "2025-10-11T14:03:10",
"upload_time_iso_8601": "2025-10-11T14:03:10.284362Z",
"url": "https://files.pythonhosted.org/packages/14/a7/8cf4f9feea5c90cd60132dd9d6562195a896691f44cd8fc317c730512f96/bach_baidu_maps-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8ea7d535742d4a980504477c1cce7cd825abe3ec0a1bd948024950c2be4e1713",
"md5": "a724f0bcb6ea65f6e30ffbb4302a3297",
"sha256": "515e13ef04eef2a3004d02ad18ac0843290df58a806f5c232332fc52c448bed2"
},
"downloads": -1,
"filename": "bach_baidu_maps-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "a724f0bcb6ea65f6e30ffbb4302a3297",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 10850,
"upload_time": "2025-10-11T14:03:11",
"upload_time_iso_8601": "2025-10-11T14:03:11.589935Z",
"url": "https://files.pythonhosted.org/packages/8e/a7/d535742d4a980504477c1cce7cd825abe3ec0a1bd948024950c2be4e1713/bach_baidu_maps-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-11 14:03:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BACH-AI-Tools",
"github_project": "baidu-maps-mcp",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "bach-baidu-maps"
}
