bach-baidu-maps 1.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (14) hide show
  1. bach_baidu_maps-1.0.0/LICENSE +21 -0
  2. bach_baidu_maps-1.0.0/PKG-INFO +137 -0
  3. bach_baidu_maps-1.0.0/README.md +120 -0
  4. bach_baidu_maps-1.0.0/pyproject.toml +26 -0
  5. bach_baidu_maps-1.0.0/setup.cfg +4 -0
  6. bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/PKG-INFO +137 -0
  7. bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/SOURCES.txt +12 -0
  8. bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/dependency_links.txt +1 -0
  9. bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/entry_points.txt +2 -0
  10. bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/requires.txt +2 -0
  11. bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/top_level.txt +1 -0
  12. bach_baidu_maps-1.0.0/src/mcp_server_baidu_maps/__init__.py +9 -0
  13. bach_baidu_maps-1.0.0/src/mcp_server_baidu_maps/__main__.py +3 -0
  14. bach_baidu_maps-1.0.0/src/mcp_server_baidu_maps/map.py +932 -0
bach_baidu_maps-1.0.0/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 baidu-maps
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
bach_baidu_maps-1.0.0/PKG-INFO ADDED
@@ -0,0 +1,137 @@
1
+ Metadata-Version: 2.4
2
+ Name: bach-baidu-maps
3
+ Version: 1.0.0
4
+ Summary: MCP Server Baidu Maps Enhanced - HTTP call Baidu Map API for MCP
5
+ Author-email: bachstudio <bachstudio@example.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/bachstudio-org/baidu-maps-mcp
8
+ Project-URL: Repository, https://github.com/bachstudio-org/baidu-maps-mcp
9
+ Project-URL: Bug Reports, https://github.com/bachstudio-org/baidu-maps-mcp/issues
10
+ Keywords: mcp,map,baidu,baidu-maps,fastmcp,http
11
+ Requires-Python: >=3.11
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ Requires-Dist: mcp[cli]>=1.9.0
15
+ Requires-Dist: httpx>=0.27.0
16
+ Dynamic: license-file
17
+
18
+ ## Baidu Map MCP Server (Python)
19
+
20
+ ### 🚀 快速启动（推荐）
21
+
22
+ #### 使用 UVX 一键启动
23
+
24
+ ```bash
25
+ uvx mcp-server-baidu-maps-enhanced
26
+ ```
27
+
28
+ #### 在 Cursor/Cherry Studio 中配置
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "baidu-maps-enhanced": {
34
+ "command": "uvx",
35
+ "args": ["mcp-server-baidu-maps-enhanced"],
36
+ "env": {
37
+ "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
38
+ }
39
+ }
40
+ }
41
+ }
42
+ ```
43
+
44
+ **包地址**: https://pypi.org/project/mcp-server-baidu-maps-enhanced/
45
+
46
+ ---
47
+
48
+ ### 传统方式：搭建 Python 虚拟环境
49
+
50
+ 我们推荐通过`uv`构建虚拟环境来运行 MCP server，关于`uv 你可以在[这里](https://docs.astral.sh/uv/getting-started/features/)找到一些说明。
51
+
52
+ 按照[官方流程](https://modelcontextprotocol.io/quickstart/server)，你会安装`Python`包管理工具`uv`。除此之外，你也可以尝试其他方法（如`Anaconda`）来创建你的`Python`虚拟环境。
53
+
54
+ 通过`uv`添加`mcp`依赖
55
+
56
+ ```bash
57
+ uv add "mcp[cli]"
58
+ ```
59
+
60
+ 验证 mcp 依赖是否安装成功，执行如下命令
61
+
62
+ ```bash
63
+ uv run mcp
64
+ ```
65
+
66
+ 当出现下图时代表安装成功
67
+
68
+ ![](../../../img/uv_install_success.png)
69
+
70
+ 通过`uv`安装`python`，最低版本要求为 3.11
71
+
72
+ ```bash
73
+ uv python install 3.11
74
+ ```
75
+
76
+ ### 获取 MCP Server
77
+
78
+ 前往百度地图 Mcp Server 官方[开源仓库](https://github.com/baidu-maps/mcp/tree/main/src/baidu-map/python)下载
79
+
80
+ ### 配置本地项目
81
+
82
+ 通过`uv`创建一个项目
83
+
84
+ ```bash
85
+ uv init mcp_server_baidu_maps
86
+ ```
87
+
88
+ 将`map.py`拷贝到该目录下，通过如下命令测试 mcp server 是否正常运行
89
+
90
+ ```bash
91
+ uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
92
+ # 如果是mac，需要加转义符
93
+ uv run --with mcp\[cli\] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
94
+ ```
95
+
96
+ 如果没有报错则 MCP Server 启动成功
97
+
98
+ ### 在 Cursor 中使用
99
+
100
+ 打开`Cursor`配置，在 MCP 中添加 MCP Server
101
+
102
+ ![](../../../img/cursor_setting.png)
103
+
104
+ 在文件中添加如下内容后保存
105
+
106
+ ```json
107
+ {
108
+ "mcpServers": {
109
+ "baidu-map": {
110
+ "command": "uv",
111
+ "args": [
112
+ "run",
113
+ "--with",
114
+ "mcp[cli]",
115
+ "mcp",
116
+ "run",
117
+ "{YOUR_PATH}/mcp_server_baidu_maps/map.py"
118
+ ],
119
+ "env": {
120
+ "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
121
+ }
122
+ }
123
+ }
124
+ }
125
+ ```
126
+
127
+ 回到配置，此时百度 MCP Server 已经启用
128
+
129
+ ![](../../../img/cursor_run_mcp_success.png)
130
+
131
+ ### 测试
132
+
133
+ 行程规划：
134
+
135
+ ![](../../../img/cursor_test_1.png)
136
+
137
+ ![](../../../img/cursor_test_2.png)
bach_baidu_maps-1.0.0/README.md ADDED
@@ -0,0 +1,120 @@
1
+ ## Baidu Map MCP Server (Python)
2
+
3
+ ### 🚀 快速启动（推荐）
4
+
5
+ #### 使用 UVX 一键启动
6
+
7
+ ```bash
8
+ uvx mcp-server-baidu-maps-enhanced
9
+ ```
10
+
11
+ #### 在 Cursor/Cherry Studio 中配置
12
+
13
+ ```json
14
+ {
15
+ "mcpServers": {
16
+ "baidu-maps-enhanced": {
17
+ "command": "uvx",
18
+ "args": ["mcp-server-baidu-maps-enhanced"],
19
+ "env": {
20
+ "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
21
+ }
22
+ }
23
+ }
24
+ }
25
+ ```
26
+
27
+ **包地址**: https://pypi.org/project/mcp-server-baidu-maps-enhanced/
28
+
29
+ ---
30
+
31
+ ### 传统方式：搭建 Python 虚拟环境
32
+
33
+ 我们推荐通过`uv`构建虚拟环境来运行 MCP server，关于`uv 你可以在[这里](https://docs.astral.sh/uv/getting-started/features/)找到一些说明。
34
+
35
+ 按照[官方流程](https://modelcontextprotocol.io/quickstart/server)，你会安装`Python`包管理工具`uv`。除此之外，你也可以尝试其他方法（如`Anaconda`）来创建你的`Python`虚拟环境。
36
+
37
+ 通过`uv`添加`mcp`依赖
38
+
39
+ ```bash
40
+ uv add "mcp[cli]"
41
+ ```
42
+
43
+ 验证 mcp 依赖是否安装成功，执行如下命令
44
+
45
+ ```bash
46
+ uv run mcp
47
+ ```
48
+
49
+ 当出现下图时代表安装成功
50
+
51
+ ![](../../../img/uv_install_success.png)
52
+
53
+ 通过`uv`安装`python`，最低版本要求为 3.11
54
+
55
+ ```bash
56
+ uv python install 3.11
57
+ ```
58
+
59
+ ### 获取 MCP Server
60
+
61
+ 前往百度地图 Mcp Server 官方[开源仓库](https://github.com/baidu-maps/mcp/tree/main/src/baidu-map/python)下载
62
+
63
+ ### 配置本地项目
64
+
65
+ 通过`uv`创建一个项目
66
+
67
+ ```bash
68
+ uv init mcp_server_baidu_maps
69
+ ```
70
+
71
+ 将`map.py`拷贝到该目录下，通过如下命令测试 mcp server 是否正常运行
72
+
73
+ ```bash
74
+ uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
75
+ # 如果是mac，需要加转义符
76
+ uv run --with mcp\[cli\] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
77
+ ```
78
+
79
+ 如果没有报错则 MCP Server 启动成功
80
+
81
+ ### 在 Cursor 中使用
82
+
83
+ 打开`Cursor`配置，在 MCP 中添加 MCP Server
84
+
85
+ ![](../../../img/cursor_setting.png)
86
+
87
+ 在文件中添加如下内容后保存
88
+
89
+ ```json
90
+ {
91
+ "mcpServers": {
92
+ "baidu-map": {
93
+ "command": "uv",
94
+ "args": [
95
+ "run",
96
+ "--with",
97
+ "mcp[cli]",
98
+ "mcp",
99
+ "run",
100
+ "{YOUR_PATH}/mcp_server_baidu_maps/map.py"
101
+ ],
102
+ "env": {
103
+ "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
104
+ }
105
+ }
106
+ }
107
+ }
108
+ ```
109
+
110
+ 回到配置，此时百度 MCP Server 已经启用
111
+
112
+ ![](../../../img/cursor_run_mcp_success.png)
113
+
114
+ ### 测试
115
+
116
+ 行程规划：
117
+
118
+ ![](../../../img/cursor_test_1.png)
119
+
120
+ ![](../../../img/cursor_test_2.png)
bach_baidu_maps-1.0.0/pyproject.toml ADDED
@@ -0,0 +1,26 @@
1
+ [project]
2
+ name = "bach-baidu-maps"
3
+ version = "1.0.0"
4
+ description = "MCP Server Baidu Maps Enhanced - HTTP call Baidu Map API for MCP"
5
+ readme = "README.md"
6
+ requires-python = ">=3.11"
7
+ authors = [{ name = "bachstudio", email = "bachstudio@example.com" }]
8
+ keywords = ["mcp", "map", "baidu", "baidu-maps", "fastmcp", "http"]
9
+ license = { text = "MIT" }
10
+ dependencies = [
11
+ "mcp[cli]>=1.9.0",
12
+ "httpx>=0.27.0",
13
+ ]
14
+
15
+ [project.urls]
16
+ "Homepage" = "https://github.com/bachstudio-org/baidu-maps-mcp"
17
+ "Repository" = "https://github.com/bachstudio-org/baidu-maps-mcp"
18
+ "Bug Reports" = "https://github.com/bachstudio-org/baidu-maps-mcp/issues"
19
+
20
+ [project.scripts]
21
+ bach-baidu-maps = "mcp_server_baidu_maps:main"
22
+
23
+ [build-system]
24
+ requires = ["setuptools>=61.0", "wheel"]
25
+ build-backend = "setuptools.build_meta"
26
+
bach_baidu_maps-1.0.0/setup.cfg ADDED
@@ -0,0 +1,4 @@
1
+ [egg_info]
2
+ tag_build =
3
+ tag_date = 0
4
+
bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/PKG-INFO ADDED
@@ -0,0 +1,137 @@
1
+ Metadata-Version: 2.4
2
+ Name: bach-baidu-maps
3
+ Version: 1.0.0
4
+ Summary: MCP Server Baidu Maps Enhanced - HTTP call Baidu Map API for MCP
5
+ Author-email: bachstudio <bachstudio@example.com>
6
+ License: MIT
7
+ Project-URL: Homepage, https://github.com/bachstudio-org/baidu-maps-mcp
8
+ Project-URL: Repository, https://github.com/bachstudio-org/baidu-maps-mcp
9
+ Project-URL: Bug Reports, https://github.com/bachstudio-org/baidu-maps-mcp/issues
10
+ Keywords: mcp,map,baidu,baidu-maps,fastmcp,http
11
+ Requires-Python: >=3.11
12
+ Description-Content-Type: text/markdown
13
+ License-File: LICENSE
14
+ Requires-Dist: mcp[cli]>=1.9.0
15
+ Requires-Dist: httpx>=0.27.0
16
+ Dynamic: license-file
17
+
18
+ ## Baidu Map MCP Server (Python)
19
+
20
+ ### 🚀 快速启动（推荐）
21
+
22
+ #### 使用 UVX 一键启动
23
+
24
+ ```bash
25
+ uvx mcp-server-baidu-maps-enhanced
26
+ ```
27
+
28
+ #### 在 Cursor/Cherry Studio 中配置
29
+
30
+ ```json
31
+ {
32
+ "mcpServers": {
33
+ "baidu-maps-enhanced": {
34
+ "command": "uvx",
35
+ "args": ["mcp-server-baidu-maps-enhanced"],
36
+ "env": {
37
+ "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
38
+ }
39
+ }
40
+ }
41
+ }
42
+ ```
43
+
44
+ **包地址**: https://pypi.org/project/mcp-server-baidu-maps-enhanced/
45
+
46
+ ---
47
+
48
+ ### 传统方式：搭建 Python 虚拟环境
49
+
50
+ 我们推荐通过`uv`构建虚拟环境来运行 MCP server，关于`uv 你可以在[这里](https://docs.astral.sh/uv/getting-started/features/)找到一些说明。
51
+
52
+ 按照[官方流程](https://modelcontextprotocol.io/quickstart/server)，你会安装`Python`包管理工具`uv`。除此之外，你也可以尝试其他方法（如`Anaconda`）来创建你的`Python`虚拟环境。
53
+
54
+ 通过`uv`添加`mcp`依赖
55
+
56
+ ```bash
57
+ uv add "mcp[cli]"
58
+ ```
59
+
60
+ 验证 mcp 依赖是否安装成功，执行如下命令
61
+
62
+ ```bash
63
+ uv run mcp
64
+ ```
65
+
66
+ 当出现下图时代表安装成功
67
+
68
+ ![](../../../img/uv_install_success.png)
69
+
70
+ 通过`uv`安装`python`，最低版本要求为 3.11
71
+
72
+ ```bash
73
+ uv python install 3.11
74
+ ```
75
+
76
+ ### 获取 MCP Server
77
+
78
+ 前往百度地图 Mcp Server 官方[开源仓库](https://github.com/baidu-maps/mcp/tree/main/src/baidu-map/python)下载
79
+
80
+ ### 配置本地项目
81
+
82
+ 通过`uv`创建一个项目
83
+
84
+ ```bash
85
+ uv init mcp_server_baidu_maps
86
+ ```
87
+
88
+ 将`map.py`拷贝到该目录下，通过如下命令测试 mcp server 是否正常运行
89
+
90
+ ```bash
91
+ uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
92
+ # 如果是mac，需要加转义符
93
+ uv run --with mcp\[cli\] mcp run {YOUR_PATH}/mcp_server_baidu_maps/map.py
94
+ ```
95
+
96
+ 如果没有报错则 MCP Server 启动成功
97
+
98
+ ### 在 Cursor 中使用
99
+
100
+ 打开`Cursor`配置，在 MCP 中添加 MCP Server
101
+
102
+ ![](../../../img/cursor_setting.png)
103
+
104
+ 在文件中添加如下内容后保存
105
+
106
+ ```json
107
+ {
108
+ "mcpServers": {
109
+ "baidu-map": {
110
+ "command": "uv",
111
+ "args": [
112
+ "run",
113
+ "--with",
114
+ "mcp[cli]",
115
+ "mcp",
116
+ "run",
117
+ "{YOUR_PATH}/mcp_server_baidu_maps/map.py"
118
+ ],
119
+ "env": {
120
+ "BAIDU_MAPS_API_KEY": "<YOUR_API_KEY>"
121
+ }
122
+ }
123
+ }
124
+ }
125
+ ```
126
+
127
+ 回到配置，此时百度 MCP Server 已经启用
128
+
129
+ ![](../../../img/cursor_run_mcp_success.png)
130
+
131
+ ### 测试
132
+
133
+ 行程规划：
134
+
135
+ ![](../../../img/cursor_test_1.png)
136
+
137
+ ![](../../../img/cursor_test_2.png)
bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/SOURCES.txt ADDED
@@ -0,0 +1,12 @@
1
+ LICENSE
2
+ README.md
3
+ pyproject.toml
4
+ src/bach_baidu_maps.egg-info/PKG-INFO
5
+ src/bach_baidu_maps.egg-info/SOURCES.txt
6
+ src/bach_baidu_maps.egg-info/dependency_links.txt
7
+ src/bach_baidu_maps.egg-info/entry_points.txt
8
+ src/bach_baidu_maps.egg-info/requires.txt
9
+ src/bach_baidu_maps.egg-info/top_level.txt
10
+ src/mcp_server_baidu_maps/__init__.py
11
+ src/mcp_server_baidu_maps/__main__.py
12
+ src/mcp_server_baidu_maps/map.py
bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
1
+ [console_scripts]
2
+ bach-baidu-maps = mcp_server_baidu_maps:main
bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/requires.txt ADDED
@@ -0,0 +1,2 @@
1
+ mcp[cli]>=1.9.0
2
+ httpx>=0.27.0
bach_baidu_maps-1.0.0/src/bach_baidu_maps.egg-info/top_level.txt ADDED
@@ -0,0 +1 @@
1
+ mcp_server_baidu_maps
bach_baidu_maps-1.0.0/src/mcp_server_baidu_maps/__init__.py ADDED
@@ -0,0 +1,9 @@
1
+ # __init__.py
2
+ from .map import mcp
3
+
4
+ def main():
5
+ """MCP Baidu Maps Server - HTTP call Baidu Map API for MCP"""
6
+ mcp.run()
7
+
8
+ if __name__ == "__main__":
9
+ main()
bach_baidu_maps-1.0.0/src/mcp_server_baidu_maps/__main__.py ADDED
@@ -0,0 +1,3 @@
1
+ from mcp_server_baidu_maps import main
2
+
3
+ main()