认证MCP服务器
](https://www.npmjs.com/package/@andrijdavid/vinted-mcp) 
用于Vinted搜索和分析的MCP服务器,提供搜索列表、获取商品详细信息、检查卖家资料、比较各国价格和展示趋势商品的工具。
它还公开了受支持国家和类别数据的资源。
免责声明:本项目与Vinted或其任何子公司或附属公司没有附属关系、关联关系、授权、背书,也没有以任何方式正式联系。Vinted官方网站可以在 vinted.com.
客户端支持
此服务器与支持本地 stdio 服务器。
热门客户端和设置文档:
- 克劳德桌面(本地):https://support.claude.com/en/articles/10949351-getting-started-with-local-mcp-servers-on-claude-desktop
- 克劳德桌面(远程):https://support.claude.com/en/articles/11175166-getting-started-with-custom-connectors-using-remote-mcp
- ChatGPT(MCP开发者模式):https://platform.openai.com/docs/guides/developer-mode
- ChatGPT(MCP和连接器):https://platform.openai.com/docs/guides/tools-remote-mcp
- 光标:https://docs.cursor.com/context/model-context-protocol
- 风浪:https://docs.windsurf.com/windsurf/cascade/mcp
- 克莱恩:https://docs.cline.bot/mcp/configuring-mcp-servers
- 完整的MCP客户端目录:https://modelcontextprotocol.io/clients
快速启动
选项1:npx
将此添加到您的MCP客户端配置中:
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "@andrijdavid/vinted-mcp"]
}
}
}选项1b:双层床(金丝雀)
bunx @andrijdavid/vinted-mcp@next这将在中启动服务器 stdio 模式并等待MCP客户端。
选项2:全局安装
npm install -g @andrijdavid/vinted-mcp然后配置:
{
"mcpServers": {
"vinted": {
"command": "vinted-mcp"
}
}
}在网络模式下运行(基于TCP的流式HTTP)
如果您需要一个网络端点而不是stdio,请运行:
VINTED_MCP_TRANSPORT=http VINTED_MCP_HOST=127.0.0.1 VINTED_MCP_PORT=3001 bunx @andrijdavid/vinted-mcp@next可选:
VINTED_MCP_PATH(默认值/mcp)VINTED_MCP_ENABLE_LEGACY_SSE(默认值true)VINTED_MCP_LEGACY_SSE_PATH(默认值/sse)VINTED_MCP_LEGACY_MESSAGES_PATH(默认值/messages)
默认端点:
- 流式HTTP(推荐):
http://127.0.0.1:3001/mcp - 传统SSE(老客户):
http://127.0.0.1:3001/sse
CLI使用和环境变量
内联传递env变量(macOS/Linux)
VINTED_AUTH_MODE=env \
VINTED_AUTH_COOKIES='session_cookie=your_value; other_cookie=your_value' \
VINTED_AUTH_CSRF_TOKEN='your_csrf_token' \
bunx @andrijdavid/vinted-mcp@next内联传递env变量(PowerShell)
$env:VINTED_AUTH_MODE = "env"
$env:VINTED_AUTH_COOKIES = "session_cookie=your_value; other_cookie=your_value"
$env:VINTED_AUTH_CSRF_TOKEN = "your_csrf_token"
bunx @andrijdavid/vinted-mcp@next内联传递env变量(Windows命令提示符)
set VINTED_AUTH_MODE=env
set VINTED_AUTH_COOKIES=session_cookie=your_value; other_cookie=your_value
set VINTED_AUTH_CSRF_TOKEN=your_csrf_token
bunx @andrijdavid/vinted-mcp@next使用本地 .env 文件
服务器自动加载 .env 从当前工作目录。
cp .env.example .env
bunx @andrijdavid/vinted-mcp@next使用env从CLI运行网络模式
VINTED_MCP_TRANSPORT=http \
VINTED_MCP_HOST=127.0.0.1 \
VINTED_MCP_PORT=3001 \
bunx @andrijdavid/vinted-mcp@nextWindows命令提示符:
set VINTED_MCP_TRANSPORT=http
set VINTED_MCP_HOST=127.0.0.1
set VINTED_MCP_PORT=3001
bunx @andrijdavid/vinted-mcp@next身份验证和环境
服务器自动加载 .env 如果存在,请从工作目录中删除。
从示例文件开始:
cp .env.example .env主要变量:
VINTED_AUTH_MODE:http,playwright,或envVINTED_AUTH_COOKIES:cookie头字符串或JSON对象字符串VINTED_AUTH_CSRF_TOKEN:CSRF令牌VINTED_AUTH_ACCESS_TOKEN:可选不记名代币VINTED_PROXY_URL:可选代理URLVINTED_MAX_CONCURRENCY:可选调整VINTED_REQUEST_DELAY_MS:可选调整VINTED_MAX_RETRIES:可选调整
带有env-auth的客户端配置示例:
{
"mcpServers": {
"vinted": {
"command": "npx",
"args": ["-y", "@andrijdavid/vinted-mcp"],
"env": {
"VINTED_AUTH_MODE": "env",
"VINTED_AUTH_COOKIES": "session_cookie=your_value; other_cookie=your_value",
"VINTED_AUTH_CSRF_TOKEN": "your_csrf_token"
}
}
}
}如何获取Cookie和CSRF令牌
- 在浏览器中登录Vinted。
- 打开开发人员工具。
- 打开
Network并刷新。 - 打开任意
https://www.vinted./api/...请求。 - 复制自
Request Headers:
- cookie -> VINTED_AUTH_COOKIES - x-csrf-token -> VINTED_AUTH_CSRF_TOKEN
- 可选:复制
authorization: Bearer ...令牌进入VINTED_AUTH_ACCESS_TOKEN.
安全注意事项:
- 将这些价值观视为秘密
- 永不承诺
.env - 如果暴露,则旋转令牌/Cookie
工具
search_items
使用国家、价格范围、品牌ID、类别、条件、排序和限制等过滤器搜索列表。
get_item
按以下方式获取项目详细信息 itemId 或 url.
get_seller
通过以下方式获取卖家资料数据和可选的最新商品 sellerId 或 url.
compare_prices
比较各国查询的平均价格和中位数价格。
get_trending
按参与度得分返回趋势项目。
资源
vinted://countriesvinted://categories
资源模板
vinted://item/{country}/{itemId}vinted://seller/{country}/{sellerId}vinted://search/{country}/{query}
这些模板允许客户端快速创建直接资源URI。
提示模板
find_best_dealscreen_sellersearch_item_with_filterstrending_reportbuy_or_skip_decisionresale_arbitrage_estimator
这些预定义的提示帮助客户端引导常见的Vinted工作流。
支持的国家: fr, de, uk, it, es, nl, pl, pt, be, at, lt, cz, sk, hu, ro, hr, fi, dk, se.
本地开发
npm install
npm run build
npm run bundle
npm start测试
运行协议级测试:
npm test运行实时集成测试:
RUN_LIVE_MCP_TESTS=1 npm test许可证
根据以下许可 AGPL-3.0-or-later.
看 LICENSE.md.
