ZORA MCP Service

MCP地图位置

提供方 JimmyNguyen09-AI

地图位置 stdio · 本地进程 API Key 社区 / 第三方
查看接入方式

ZORA MCP Service是一个基于FastAPI的微服务,为ZORA AI聊天机器人提供天气、时间和所有者信息的RESTful API接口。

一句话选型结论

按资料字段整理

ZORA MCP Service 属于地图位置类 MCP 服务器,stdio · 本地进程,API Key,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类地图位置 传输方式stdio · 本地进程 鉴权API Key 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

地图位置
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

天气服务Python本地部署时间服务API服务微服务聊天机器人集成

安装与配置

stdio · 本地进程 API Key
客户端在本机拉起子进程,数据不出本机
pip install fastapi uvicorn httpx pytz

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
地址与路线

查地址、算路线、找附近地点。

位置检索

按区域筛门店、站点与设施。

地理数据

拉取经纬度、行政区等地理信息。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在地图位置场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
ZORA MCP Service当前 未标注 stdio · 本地进程 本地部署 有 2026-05-17
MCP Server C2f246e3 20 stdio · 本地进程 本地部署 有 2026-05-17
OpenStreetMap MCP Server 12 stdio · 本地进程 本地部署 有 2026-05-18
Baidu Maps 10 stdio · 本地进程 本地部署 有 2026-05-17
Google Maps (google-maps-aa2563d3) 7 未标注 未标注 无 2026-05-17
generative-ai 未标注 stdio · 本地进程 本地部署 有 2026-04-17

服务器档案

地图位置
字段来自项目仓库与公开索引,中文说明由本站标注
提供方JimmyNguyen09-AI上游标注的维护方 JimmyNguyen09-AI
分类地图位置本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.0 KB
来自项目仓库与上游目录的原文,未做删改

🚀 ZORA MCP服务

模型上下文协议服务 -独立的API服务,为ZORA AI聊天机器人提供天气、时间和所有者信息端点。

📋 概述

MCP Service是一个基于FastAPI的微服务,通过RESTful API为ZORA AI聊天机器人提供专用工具。使用 开放天气 (完全免费)天气数据,不需要API密钥。

特性

  • ✅ 100%免费 -使用Open-Meteo(不需要API密钥)
  • ✅ RESTful API -易于集成
  • ✅ 实时天气 -30+越南城市
  • ✅ 世界时间 -15+个国家/时区
  • ✅ 自动文档 -包含Swagger用户界面
  • ✅ 快速可靠 -平均响应时间\<200ms

🌐 API终点

基础URL```

http://localhost:8001


______________________________________________________________________

### 1.️⃣ 天气API

获取越南城市的当前天气。

**端点:**```
GET /api/weather?city={city_name}

参数:

名称 类型 必填 描述
city string Yes 城市名称(例如,河内、胡志明、岘港)

请求示例:```bash
curl "http://localhost:8001/api/weather?city=Hanoi"


**示例响应:**```json
{
&quot;success&quot;: true,
&quot;city&quot;: &quot;Hanoi&quot;,
&quot;temperature&quot;: 28.5,
&quot;description&quot;: &quot;Trời quang đãng&quot;,
&quot;humidity&quot;: 65,
&quot;wind_speed&quot;: 12.5,
&quot;weather_code&quot;: 0,
&quot;emoji&quot;: &quot;☀️&quot;
}

支持城市(30+):```
Hà Nội, TP HCM (Sài Gòn), Đà Nẵng, Huế, Nha Trang,
Cần Thơ, Hải Phòng, Vũng Tàu, Biên Hòa, Đà Lạt,
Quy Nhơn, Hạ Long, Vinh, Buôn Ma Thuột, Phan Thiết, ...


**天气代码:**
<0>天空晴朗>☀️ |
1-2部分是云。🌤️ |
3微米。☁️ |
45-48有雾🌫️ |
51-67雨🌧️ |
71-77下雪了❄️ |
80-82集雨🌧️ |
95-99风暴⛈️ |

______________________________________________________________________

### 2.️⃣ 时间API

获取任何国家的当前时间。

**端点:**```
GET /api/time?country={country_name}

参数:

名称 类型 必填 描述
country string Yes 国家名称(例如越南、美国、日本)

请求示例:```bash
curl "http://localhost:8001/api/time?country=Vietnam"


**示例响应:**```json
{
&quot;success&quot;: true,
&quot;country&quot;: &quot;Vietnam&quot;,
&quot;timezone&quot;: &quot;Asia/Ho_Chi_Minh&quot;,
&quot;current_time&quot;: &quot;14:30:45&quot;,
&quot;date&quot;: &quot;15/11/2025&quot;,
&quot;timestamp&quot;: &quot;2025-11-15T14:30:45+07:00&quot;
}

支持的国家(15+):```
Việt Nam, Mỹ (USA), Nhật Bản (Japan), Anh (UK),
Pháp (France), Đức (Germany), Singapore, Thái Lan (Thailand),
Hàn Quốc (South Korea), Úc (Australia), Canada,
Ấn Độ (India), Indonesia, Malaysia, Philippines


______________________________________________________________________

### 3.️⃣ 所有者信息API

获取有关ZORA AI创建者的信息。

**端点:**```
GET /api/owner

参数:
无

请求示例:```bash
curl "http://localhost:8001/api/owner"


**示例响应:**```json
{
&quot;success&quot;: true,
&quot;name&quot;: &quot;Nguyễn Trung Thành (Jimmy Nguyen)&quot;,
&quot;phone&quot;: &quot;0432047700&quot;,
&quot;email&quot;: &quot;ng.trungthanh04@gmail.com&quot;,
&quot;role&quot;: &quot;AI Developer &amp; Software Engineer&quot;,
&quot;bio&quot;: &quot;Tôi là Nguyễn Trung Thành, người sáng tạo ra ZORA AI...&quot;,
&quot;skills&quot;: [
&quot;Python&quot;,
&quot;FastAPI&quot;,
&quot;LangChain&quot;,
&quot;Machine Learning&quot;,
&quot;Natural Language Processing&quot;,
&quot;RAG Systems&quot;,
&quot;PostgreSQL&quot;,
&quot;Docker&quot;,
&quot;MCP Protocol&quot;
]
}

4.️⃣ 工具元数据API

获取包含用于检测的关键字的可用工具列表。

端点:```
GET /api/tools


**参数:**
无

**请求示例:**```bash
curl &quot;http://localhost:8001/api/tools&quot;

示例响应:```json
{
"tools": [
{
"name": "get_weather",
"endpoint": "/api/weather",
"method": "GET",
"description": "Lấy thông tin thời tiết hiện tại của một thành phố ở Việt Nam",
"parameters": {
"city": {
"type": "string",
"required": true,
"description": "Tên thành phố (vd: Hanoi, Ho Chi Minh, Da Nang)"
}
},
"keywords": [
"thời tiết", "nhiệt độ", "nóng", "lạnh", "mưa", "nắng",
"weather", "temperature", "hot", "cold", "rain", "sunny"
],
"example": "GET /api/weather?city=Hanoi"
},
// ... more tools
],
"cities": ["Hanoi", "Ho Chi Minh City", "Da Nang", ...],
"countries": ["vietnam", "usa", "japan", ...]
}


______________________________________________________________________

### 5.️⃣ 健康检查

检查服务状态。

**端点:**```
GET /health

示例响应:```json
{
"status": "healthy",
"timestamp": "2025-11-15T14:30:45.123456"
}


______________________________________________________________________

## 🚀 快速开始

### 安装

1. **克隆或创建项目:**```bash
mkdir mcp-service
cd mcp-service
  1. 安装依赖项:```bash
    pip install fastapi uvicorn httpx pytz

3. **创建 `main.py`** 带有MCP服务代码

1. **运行服务:**```bash
python main.py

或者直接使用uvicorn:```bash
uvicorn main:app --host 0.0.0.0 --port 8001 --reload


5. **访问Swagger用户界面:**```
http://localhost:8001/docs

Docker部署

Dockerfile:```dockerfile
FROM python:3.11-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

COPY main.py .

EXPOSE 8001

CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8001"]


**构建并运行:**```bash
docker build -t zora-mcp-service .
docker run -p 8001:8001 zora-mcp-service

📊 演出

基准(来自越南):```

Weather API:
├── Average latency: 180ms
├── Success rate: 99.9%
├── Rate limit: 10,000+ calls/day
└── Uptime: 99.9%+

Time API:
├── Average latency: <5ms
├── Success rate: 100%
├── Rate limit: Unlimited
└── Uptime: 100%

Owner Info API:
├── Average latency: <5ms
├── Success rate: 100%
├── Rate limit: Unlimited
└── Uptime: 100%


______________________________________________________________________

## 🔧 配置

### 环境变量

创建 `.env` 文件(可选):```bash
# Service configuration
SERVICE_HOST=0.0.0.0
SERVICE_PORT=8001

# CORS settings (if needed)
ALLOWED_ORIGINS=http://localhost:3000,http://localhost:8000

自定义配置

编辑 main.py 自定义:

添加新城市:```python
VIETNAM_CITIES = {
"your_city": ("Your City Name", latitude, longitude),

Example:

"phu quoc": ("Phu Quoc", 10.2291, 103.9673),
}


**添加新国家:**```python
COUNTRY_TIMEZONES = {
&quot;your_country&quot;: &quot;Continent/City&quot;,
# Example:
&quot;brazil&quot;: &quot;America/Sao_Paulo&quot;,
}

🧪 测试

手动测试

测试天气:```bash
curl "http://localhost:8001/api/weather?city=Hanoi"


**测试时间:**```bash
curl &quot;http://localhost:8001/api/time?country=Vietnam&quot;

测试所有者信息:```bash
curl "http://localhost:8001/api/owner"


### 自动化测试

创建 `test_mcp_service.py`:```python
import httpx
import pytest

BASE_URL = &quot;http://localhost:8001&quot;

@pytest.mark.asyncio
async def test_weather_api():
async with httpx.AsyncClient() as client:
response = await client.get(f&quot;{BASE_URL}/api/weather?city=Hanoi&quot;)
assert response.status_code == 200
data = response.json()
assert data[&quot;success&quot;] == True
assert &quot;temperature&quot; in data

@pytest.mark.asyncio
async def test_time_api():
async with httpx.AsyncClient() as client:
response = await client.get(f&quot;{BASE_URL}/api/time?country=Vietnam&quot;)
assert response.status_code == 200
data = response.json()
assert data[&quot;success&quot;] == True
assert &quot;current_time&quot; in data

@pytest.mark.asyncio
async def test_owner_api():
async with httpx.AsyncClient() as client:
response = await client.get(f&quot;{BASE_URL}/api/owner&quot;)
assert response.status_code == 200
data = response.json()
assert data[&quot;success&quot;] == True
assert &quot;name&quot; in data

运行测试:```bash
pytest test_mcp_service.py -v


______________________________________________________________________

## 🔐 安全

### 最佳实践

1. **速率限制** (必要时添加):```python
from slowapi import Limiter
from slowapi.util import get_remote_address

limiter = Limiter(key_func=get_remote_address)
app.state.limiter = limiter

@app.get(&quot;/api/weather&quot;)
@limiter.limit(&quot;100/minute&quot;)
async def get_weather(request: Request, city: str):
# ...
  1. API密钥验证 (可选):```python
    from fastapi import Header, HTTPException

async def verify_api_key(x_api_key: str = Header(...)):
if x_api_key != "your-secret-key":
raise HTTPException(status_code=401, detail="Invalid API key")


3. **CORS配置:**```python
app.add_middleware(
CORSMiddleware,
allow_origins=[&quot;https://your-frontend.com&quot;],  # Specific domains only
allow_credentials=True,
allow_methods=[&quot;GET&quot;],
allow_headers=[&quot;*&quot;],
)

📈 监控

健康检查集成

正常运行时间监控:```bash
*/5 * * * * curl -f http://localhost:8001/health || alert


**普罗米修斯指标** (必要时添加):```python
from prometheus_fastapi_instrumentator import Instrumentator

Instrumentator().instrument(app).expose(app)

日志记录```python

import logging

logging.basicConfig(
level=logging.INFO,
format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

logger = logging.getLogger(name)

@app.get("/api/weather")
async def get_weather(city: str):
logger.info(f"Weather request for city: {city}")

...


______________________________________________________________________

## 🐛 故障排除

### 常见问题

**1.服务无法启动:**```bash
# Check if port 8001 is in use
lsof -i :8001
# Kill process if needed
kill -9

2.天气API返回500:

  • 检查互联网连接
  • 验证Open-Meteo API状态:https://open-meteo.com
  • 检查日志以了解详细错误

3.时间API返回错误的时区:

  • 验证国家名称拼写
  • 检查 COUNTRY_TIMEZONES 映射
  • 使用支持列表中的确切国家名称

4.CORS错误:

  • 更新 allow_origins 在CORS中间件中
  • 检查浏览器控制台以了解详细错误

📚 API集成示例

python```python

import httpx

async def get_weather(city: str):
async with httpx.AsyncClient() as client:
response = await client.get(
"http://localhost:8001/api/weather",
params={"city": city}
)
return response.json()

Usage

weather = await get_weather("Hanoi")
print(f"Temperature: {weather['temperature']}°C")


### JavaScript/TypeScript```javascript
async function getWeather(city) {
const response = await fetch(
`http://localhost:8001/api/weather?city=${city}`
);
return await response.json();
}

// Usage
const weather = await getWeather(&#x27;Hanoi&#x27;);
console.log(`Temperature: ${weather.temperature}°C`);

卷曲```bash

Weather

curl "http://localhost:8001/api/weather?city=Hanoi"

Time

curl "http://localhost:8001/api/time?country=Vietnam"

Owner Info

curl "http://localhost:8001/api/owner"


______________________________________________________________________

## 🎯 用例

### 1.聊天机器人集成```python
# In your chatbot service
if &quot;weather&quot; in user_question:
city = extract_city(user_question)
weather = await mcp_client.get_weather(city)
return format_weather_response(weather)

2.多智能体系统```python

Detect intent and call appropriate API

intents = agent_detector.detect(user_question)
for intent in intents:
if intent.type == "weather":
response = await mcp_client.get_weather(intent.params["city"])


### 3.语音助手```python
# Convert speech to text, call MCP, convert response to speech
text = speech_to_text(audio)
if &quot;thời tiết&quot; in text:
weather = await mcp_client.get_weather(extract_city(text))
audio_response = text_to_speech(format_weather(weather))

🤝 贡献

想添加更多功能吗?

思想:

  • 货币汇率
  • 新闻提要
  • 股票价格
  • 维基百科搜索
  • 计算器/数学求解器

如何做出贡献:

  1. 分叉存储库
  2. 创建特征分支
  3. 添加您的端点
  4. 彻底测试
  5. 提交拉取请求

📞 支持

造物主: 饰Jimmy Nguyen

  • 📧 电子邮件:ng.trungthanh04@gmail.com
  • 📱 电话:0432047700

服务问题:

  • 检查 /health 端点
  • 查看日志
  • 验证Open Meteo状态

📜 许可证

MIT许可证-可在您的项目中免费使用!


🎉 更新日志

v1.0.0(2025-11-15)

  • ✨ 初始版本
  • ✅ 天气API(Open-Meteo)
  • ✅ 时间API
  • ✅ 所有者信息API
  • ✅ 自动文档(Swagger)
  • ✅ 健康检查端点
  • ✅ 30+越南城市
  • ✅ 15+个国家

由以下材料制成❤️ 通过Nguyễn张

由Open Meteo提供技术支持🌤️ (免费和开源)

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
ZORA MCP Service 怎么安装?

在客户端按下面的安装命令接入:pip install fastapi uvicorn httpx pytz。装完在客户端配置里引用同一个包或端点。

ZORA MCP Service 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

ZORA MCP Service 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

ZORA MCP Service 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

ZORA MCP Service 能提供哪些能力?

资料显示能力标签包括 位置天气、Python、时间服务、微服务。具体工具清单以官方文档为准。

ZORA MCP Service 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

ZORA MCP Service 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。