Tiendanube MCP Server

MCPAI代理

提供方 AlexandreProenca

AI代理 未标注 Token 社区 / 第三方

一个完整的模型上下文协议(MCP)服务器,支持Tiendanube/Nuvemshop API,提供Docker支持和SSE传输。

一句话选型结论

按资料字段整理

Tiendanube MCP Server 属于AI代理类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权Token 部署方式支持远程部署
GitHub 星标 6 仓库热度,无公开仓库时显示未标注
工具数 30 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

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

能力标签

适用场景

MCP协议Python本地部署API服务器DockerSSE传输Tiendanube

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    确认你的客户端支持远程端点,并拿到服务地址。

  2. 2
    安装服务

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

  3. 3
    写入客户端配置

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

  4. 4
    验证是否可用

    连接成功后客户端会列出约 30 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

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

值得选的地方

  • 资料标注 30 个工具,覆盖面较广,能满足多种调用。

先想清楚的地方

  • 远程端点依赖网络与服务方可用性,注意密钥与调用额度。
  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Tiendanube MCP Server当前 30 未标注 支持远程部署 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AlexandreProenca上游标注的维护方 AlexandreProenca
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型支持远程部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

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

Tiendanube MCP服务器-Docker设置

一个完整的模型上下文协议(MCP)服务器,用于Tiendanube/Nuvmshop API,支持Docker和SSE传输。

🚀 特性

资源

  • 产品:具有高级过滤功能的完整CRUD(库存、价格、类别、SKU)
  • 订单:完整的订单管理和历史跟踪
  • 客户:客户管理,包括地址和账单
  • 分类:类别层次结构管理
  • 优惠券:优惠券管理
  • 商店:存储信息和设置

运输方式

  • ✅ SSE(服务器发送事件) -对于基于web的客户端
  • ✅ 流式HTTP -现代HTTP传输
  • ✅ 工作室 -用于CLI/终端使用

📋 先决条件

  • Docker和Docker Compose
  • Tiendanube API证书:
  • 访问令牌
  • 店铺ID

🔧 设置

1.克隆或创建项目结构```bash

mkdir tiendanube-mcp
cd tiendanube-mcp


创建以下文件:

- `tiendanube_server.py` (主服务器代码)
- `Dockerfile`
- `docker-compose.yml`
- `requirements.txt`
- `.env` (从 `.env.example`)

### 2.配置环境变量

创建 `.env` 文件:```env
TIENDANUBE_ACCESS_TOKEN=your_access_token_here
TIENDANUBE_STORE_ID=your_store_id_here
TIENDANUBE_BASE_URL=https://api.tiendanube.com/v1

# Server Configuration
MCP_TRANSPORT=sse
MCP_HOST=0.0.0.0
MCP_PORT=8080
LOG_LEVEL=INFO

3.构建和运行```bash

Build the Docker image

docker-compose build

Start the server

docker-compose up -d

View logs

docker-compose logs -f

Stop the server

docker-compose down


## 🌐 访问服务器

### 苏格兰和南方能源公司运输(默认)```
URL: http://localhost:8080/sse

可流式HTTP传输

改变 .env:```env
MCP_TRANSPORT=streamable-http
``````
URL: http://localhost:8080/mcp


## 🔍 健康检查```bash
curl http://localhost:8080/health

📊 API终点

产品

  • list_products -使用过滤器列出/搜索产品
  • get_product -按ID获取产品
  • get_product_by_sku -按SKU获取产品
  • create_product -创建具有变体的新产品
  • update_product -更新产品信息
  • delete_product -删除产品
  • update_product_stock_price -批量更新库存/价格

订单

  • list_orders -使用筛选器列出订单
  • get_order -获取订单详细信息
  • get_order_history_values -获取值更改历史记录
  • get_order_history_editions -获取版本更新日志
  • create_order -创建新订单
  • update_order -更新订单
  • close_order -关闭订单
  • open_order -重新打开订单
  • cancel_order -取消订单

客户

  • list_customers -列出/搜索客户
  • get_customer -获取客户详细信息
  • create_customer -创建新客户
  • update_customer -更新客户
  • delete_customer -删除客户

分类

  • list_categories -列出所有类别
  • get_category -获取类别详细信息
  • create_category -创建类别
  • update_category -更新类别
  • delete_category -删除类别

优惠券

  • list_coupons -列出所有优惠券
  • get_coupon -获取优惠券详细信息
  • create_coupon -创建折扣券

商店

  • get_store -获取店铺信息

🎯 用法示例

从Python客户端连接```python

import requests
import json

SSE endpoint

url = "http://localhost:8080/sse"

List products

payload = {
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "list_products",
"arguments": {
"query": "shirt",
"per_page": 10
}
},
"id": 1
}

response = requests.post(url, json=payload)
print(response.json())


### 从cURL连接```bash
# List products
curl -X POST http://localhost:8080/sse \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "list_products",
"arguments": {
"published": true,
"per_page": 20
}
},
"id": 1
}'

高级示例```bash

Get low stock products

curl -X POST http://localhost:8080/sse \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "list_products",
"arguments": {
"max_stock": 10,
"published": true
}
},
"id": 1
}'

Create order

curl -X POST http://localhost:8080/sse \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "create_order",
"arguments": {
"products": [{"variant_id": 123456, "quantity": 2}],
"customer": {
"name": "John Doe",
"email": "john@example.com"
},
"payment_status": "paid"
}
},
"id": 1
}'


## 🐳 Docker命令```bash
# Build
docker-compose build

# Start
docker-compose up -d

# Logs
docker-compose logs -f tiendanube-mcp

# Restart
docker-compose restart

# Stop
docker-compose down

# Remove everything
docker-compose down -v --rmi all

# Shell access
docker exec -it tiendanube-mcp-server bash

🔐 安全说明

  1. 永不承诺 .env 文件 -添加到 .gitignore
  2. 使用特定于环境的令牌 -单独的开发/产品凭据
  3. 启用HTTPS -使用反向代理(nginx/traefik)进行生产
  4. 速率限制 -考虑增加生产速率限制
  5. CORS配置 -如果公开,配置允许的来源

🔄 更新中```bash

Pull latest changes

git pull

Rebuild

docker-compose down
docker-compose build --no-cache
docker-compose up -d


## 📝 日志记录

日志配置为轮换:

- 最大大小:每个文件10MB
- 最大文件数:3
- 位置:Docker日志(使用 `docker-compose logs`)

查看日志:```bash
# All logs
docker-compose logs -f

# Last 100 lines
docker-compose logs --tail=100

# Specific service
docker-compose logs -f tiendanube-mcp

🐛 故障排除

服务器无法启动```bash

Check logs

docker-compose logs tiendanube-mcp

Verify environment variables

docker-compose config

Test API credentials

curl -H "Authentication: bearer YOUR_TOKEN" \
https://api.tiendanube.com/v1/YOUR_STORE_ID/store


### 连接被拒绝

- 验证端口8080是否未使用: `netstat -tuln | grep 8080`
- 检查防火墙设置
- 确保容器正在运行: `docker ps`

### 权限错误```bash
# Fix permissions
chmod +x start.sh

🌟 生产部署

使用Nginx反向代理```nginx

server {
listen 443 ssl http2;
server_name mcp.yourdomain.com;

ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;

location /sse {
proxy_pass http://localhost:8080/sse;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;

SSE specific

proxy_buffering off;
proxy_read_timeout 86400;
}
}


### 使用Docker Swarm```bash
docker stack deploy -c docker-compose.yml tiendanube

生产环境变量```env

TIENDANUBE_ACCESS_TOKEN=prod_token
TIENDANUBE_STORE_ID=prod_store_id
MCP_TRANSPORT=sse
MCP_HOST=0.0.0.0
MCP_PORT=8080
LOG_LEVEL=WARNING
```

📚 资源

  • Tiendanube API文件
  • MCP协议规范
  • Docker文档

📄 许可证

MIT许可证-有关详细信息,请参阅许可证文件

🤝 贡献

欢迎投稿!请打开问题或提交拉取请求。

📧 支持

关于以下问题:

  • 此MCP服务器:打开GitHub问题
  • API:联系Tiendanube支持
  • MCP协议:检查MCP文件

常见问题

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

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Tiendanube MCP Server 怎么在客户端里配置?

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

Tiendanube MCP Server 收费吗?

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

Tiendanube MCP Server 需要 API Key 吗?

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

Tiendanube MCP Server 能提供哪些能力?

资料显示约 30 个工具;能力标签包括 API集成、SSE传输、Docker、Python。具体工具清单以官方文档为准。

Tiendanube MCP Server 需要什么运行环境?

属于远程端点,不需要在本地装运行时。

Tiendanube MCP Server 是本地还是远程?

它是远程端点,连服务地址即可。

热门专题

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

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