快速接入百度地图MCP Server

任意支持MCP协议的平台（Claude、Cursor）都可简单接入百度地图MCP server，目前支持nodejs和python两种接入方式。同时，千帆AppBuilder平台也支持接入。

GitHub地址：https://github.com/baidu-maps/mcp

通过Python接入MCP server

1. 搭建python环境，以运行MCP server

环境搭建参考https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#overview
安装uv，uv是一个python环境管理工具，是MCP官方推荐的python项目管理工具，见https://docs.astral.sh/uv/getting-started/features/

安装python，注意uv的最低版本要求为3.11

uv python install 3.11

首先通过uv创建一个项目

uv init baidu_map_mcp_server

安装完成后，通过uv添加MCP依赖

uv add "mcp[cli]"

验证MCP依赖是否安装成功，执行如下命令

uv run mcp

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

2. 下载百度MCP Server源码 https://github.com/baidu-maps/mcp/tree/main/src/baidu-map/python

将map.py拷贝到该目录下，通过如下命令测试MCP server是否正常运行

uv run --with mcp[cli] mcp run {替换成您的路径}/baidu_map_mcp_server/map.py

# 如果是mac，需要加转义符

uv run --with mcp\[cli\] mcp run {替换成您的路径}/baidu_map_mcp_server/map.py

如果没有报错则MCP Server启动成功

3. 在Cursor中启用该MCP Server

打开Cursor配置，在MCP中添加MCP Server

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

{

  "mcpServers": {

    "baidu-map": {

      "command": "uv",

      "args": [

        "run",

        "--with",

        "mcp[cli]",

        "mcp",

        "run",

        "{替换成您的路径}/baidu_map_mcp_server/map.py"

      ],

      "env": {

        "BAIDU_MAPS_API_KEY": "{您的AK}"

      }

    }

  }

}

需要注意，如果是在claude中添加MCP，command需要写绝对路径，例如：/User/{您的账号名}/local/bin/uv，否则可能导致mcp加载失败

回到配置，此时百度MCP Server已经启用

4. 开始使用

行程规划：

通过Nodejs接入

1. 安装nodejs

https://nodejs.org/zh-cn

2. 在Claude中配置

（1） 打开Claude的Setting菜单，切换到Developer选项卡，点击”Edit Config”，用任意的文本编辑器软件打开配置文件

（2） 将以下配置添加到配置文件中，BAIDU_MAP_API_KEY 是访问百度地图开放平台API的AK，可根据此页面申请获取：https://lbs.baidu.com/faq/api?title=mcpserver/prepare

{

    "mcpServers": {

        "baidu-map": {

            "command": "npx",

            "args": [

                "-y",

                "@baidumap/mcp-server-baidu-map"

            ],

            "env": {

                "BAIDU_MAP_API_KEY": "{您的AK}"

            }

        }

    }

}

（3） 重启Claude，此时设置面板已经成功加载了百度地图MCP Server。在软件主界面对话框处可以看到有8个可用的MCP工具，点击可以查看详情。

3. 接下来就可以进行提问，验证出行规划小助手的能力了。

通过千帆AppBuilder平台接入

千帆平台接入，目前支持SDK接入或是API接入，通过AppBuilder构建一个应用，每个应用拥有一个独立的app_id，在python文件中调用对应的app_id，再调用百度地图 Python MCP Tool即可。
模板代码可向下跳转，通过SDK Agent &&地图MCP Server，拿到导航路线及路线信息，并给出出行建议。

Agent配置

将Agent的思考轮数调到6。发布应用。

调用
此代码可以当作模板，以SDK的形式调用千帆平台上已经构建好且已发布的App，再将MCP Server下载至本地，将文件相对路径写入代码即可。（注意：使用实际的app_id、token、query、MCP文件）

import os

import asyncio





import appbuilder

from appbuilder.core.console.appbuilder_client.async_event_handler import (

    AsyncAppBuilderEventHandler,

)





from appbuilder.modelcontextprotocol.client import MCPClient









class MyEventHandler(AsyncAppBuilderEventHandler):

    def __init__(self, mcp_client):

        super().__init__()

        self.mcp_client = mcp_client





    def get_current_weather(self, location=None, unit="摄氏度"):

        return "{} 的温度是 {} {}".format(location, 20, unit)





    async def interrupt(self, run_context, run_response):

        thought = run_context.current_thought

        # 绿色打印

        print("\033[1;31m", "-> Agent 中间思考: ", thought, "\033[0m")





        tool_output = []

        for tool_call in run_context.current_tool_calls:

            tool_res = ""

            if tool_call.function.name == "get_current_weather":

                tool_res = self.get_current_weather(**tool_call.function.arguments)

            else:

                print(

                    "\033[1;32m",

                    "MCP工具名称: {}, MCP参数:{}

".format(tool_call.function.name, tool_call.function.arguments),

                    "[0m",

                )

                mcp_server_result = await self.mcp_client.call_tool(

                    tool_call.function.name, tool_call.function.arguments

                )

                print("\033[1;33m", "MCP结果: {}

\033[0m".format(mcp_server_result))

                for i, content in enumerate(mcp_server_result.content):

                    if content.type == "text":

                        tool_res += mcp_server_result.content[i].text

            tool_output.append(

                {

                    "tool_call_id": tool_call.id,

                    "output": tool_res,

                }

            )

        return tool_output





    async def success(self, run_context, run_response):

        print("

\033[1;34m", "-> Agent 非流式回答: ", run_response.answer, "\033[0m")





async def agent_run(client, mcp_client, query):

    tools = mcp_client.tools





    conversation_id = await client.create_conversation()

    with await client.run_with_handler(

        conversation_id=conversation_id,

        query=query,

        tools=tools,

        event_handler=MyEventHandler(mcp_client),

    ) as run:

        await run.until_done()





### 用户Token

os.environ["APPBUILDER_TOKEN"] = (

    ""

)





async def main():

    appbuilder.logger.setLoglevel("DEBUG")

    ### 发布的应用ID

    app_id = ""

    appbuilder_client = appbuilder.AsyncAppBuilderClient(app_id)

    mcp_client = MCPClient()

    

    ### 注意这里的路径为MCP Server文件在本地的相对路径

    await mcp_client.connect_to_server("./<YOUR_FILE_PATH>/map.py")

    print(mcp_client.tools)





    await agent_run(

        appbuilder_client,

        mcp_client,

        '开车导航从北京到上海',

    )





    await appbuilder_client.http_client.session.close()









if __name__ == "__main__":

    loop = asyncio.get_event_loop()

    loop.run_until_complete(main())

结果：
经过Agent自己的思考，通过调用MCP Server 地点检索、地理编码服务、路线规划服务等多个tool，拿到导航路线及路线信息，并给出出行建议。

实际用户请求：“请为我计划一次北京赏花一日游。尽量给出更舒适的出行安排，当然，也要注意天气状况。”

思考过程：

Agent结果：

文章转载自：快速接入百度地图MCP Server