mcp-server-baidu-maps-enhanced


Namemcp-server-baidu-maps-enhanced JSON
Version 1.0.0 PyPI version JSON
download
home_pageNone
SummaryMCP Server Baidu Maps Enhanced - HTTP call Baidu Map API for MCP
upload_time2025-10-10 10:27:29
maintainerNone
docs_urlNone
authorNone
requires_python>=3.11
licenseMIT
keywords http mcp map baidu baidu-maps fastmcp
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            ## 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
```

当出现下图时代表安装成功

![](../../../img/uv_install_success.png)

通过`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

![](../../../img/cursor_setting.png)

在文件中添加如下内容后保存

```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已经启用

![](../../../img/cursor_run_mcp_success.png)

### 测试

行程规划：

![](../../../img/cursor_test_1.png)

![](../../../img/cursor_test_2.png)

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "mcp-server-baidu-maps-enhanced",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.11",
    "maintainer_email": null,
    "keywords": "http, mcp, map, baidu, baidu-maps, fastmcp",
    "author": null,
    "author_email": "Feng Rongquan <kirifeng@example.com>",
    "download_url": "https://files.pythonhosted.org/packages/7f/09/6c6ed5b7ceb88988c6d546d9d0ea57cf0f6398a4d88bdddf0564775ddfe2/mcp_server_baidu_maps_enhanced-1.0.0.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![](../../../img/uv_install_success.png)\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![](../../../img/cursor_setting.png)\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![](../../../img/cursor_run_mcp_success.png)\n\n### \u6d4b\u8bd5\n\n\u884c\u7a0b\u89c4\u5212\uff1a\n\n![](../../../img/cursor_test_1.png)\n\n![](../../../img/cursor_test_2.png)\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "MCP Server Baidu Maps Enhanced - HTTP call Baidu Map API for MCP",
    "version": "1.0.0",
    "project_urls": {
        "Bug Reports": "https://github.com/baidu-maps/mcp/issues",
        "Homepage": "https://github.com/baidu-maps/mcp",
        "Repository": "https://github.com/baidu-maps/mcp"
    },
    "split_keywords": [
        "http",
        " mcp",
        " map",
        " baidu",
        " baidu-maps",
        " fastmcp"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "97ee98d024218ba8b5a89b17a1a8ca8bb77bd172d2a05e23c78b9798e4bde96f",
                "md5": "ad2c8ca5cae9163a695490336d9598ad",
                "sha256": "5327b6d47df76602376c13b3522ef46309df91ecaef820de354eed7c8b66a8c3"
            },
            "downloads": -1,
            "filename": "mcp_server_baidu_maps_enhanced-1.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ad2c8ca5cae9163a695490336d9598ad",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.11",
            "size": 11699,
            "upload_time": "2025-10-10T10:27:28",
            "upload_time_iso_8601": "2025-10-10T10:27:28.247668Z",
            "url": "https://files.pythonhosted.org/packages/97/ee/98d024218ba8b5a89b17a1a8ca8bb77bd172d2a05e23c78b9798e4bde96f/mcp_server_baidu_maps_enhanced-1.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "7f096c6ed5b7ceb88988c6d546d9d0ea57cf0f6398a4d88bdddf0564775ddfe2",
                "md5": "ee05fe1420c0de02a5d8cac442ddcc26",
                "sha256": "c3fae4772aa1e2c47ceb50c36b619a11bb290b6709683067a737b0060f564461"
            },
            "downloads": -1,
            "filename": "mcp_server_baidu_maps_enhanced-1.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "ee05fe1420c0de02a5d8cac442ddcc26",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.11",
            "size": 12147,
            "upload_time": "2025-10-10T10:27:29",
            "upload_time_iso_8601": "2025-10-10T10:27:29.470505Z",
            "url": "https://files.pythonhosted.org/packages/7f/09/6c6ed5b7ceb88988c6d546d9d0ea57cf0f6398a4d88bdddf0564775ddfe2/mcp_server_baidu_maps_enhanced-1.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-10-10 10:27:29",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "baidu-maps",
    "github_project": "mcp",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "mcp-server-baidu-maps-enhanced"
}
None
Elapsed time: 1.31482s