Trade Me MCP服务器
MCP(模型上下文协议)服务器,允许AI助手使用自然语言搜索Trade Me列表。不需要API密钥。
设置
先决条件
- Node.js 18+
安装
cd /path/to/TradeMeMCP
npm install添加到克劳德代码
创建或编辑 .mcp.json 在项目根目录中(或 ~/.claude/.mcp.json 全球访问):
{
"mcpServers": {
"trademe": {
"command": "npx",
"args": ["tsx", "/path/to/TradeMeMCP/src/index.ts"]
}
}
}重新启动Claude Code以获取新服务器。
工具
search_trademe
在所有Trade Me市场类别中进行一般搜索——电子产品、服装、收藏品等。
参数: search_string (必填), category, sort_order, condition, price_min, price_max, buy_now, region, page, rows
示例提示:
- “给我找个200美元以下的二手帐篷”
- “在惠灵顿搜索PS5控制器”
- “今天有哪些任天堂Switch游戏上市?”
搜索引擎
在Trade Me Motors中搜索带有品牌/型号/年份过滤的车辆。
参数: search_string, make, model, year_min, year_max, price_min, price_max, odometer_min, odometer_max, transmission, body_style, sort_order, region, page, rows
示例提示:
- “查找3万美元以下、行驶里程不到10万公里的自动SUV”
- “给我看看2018年或更新的丰田Hiluxes”
搜索_财产
在Trade Me Property搜索住宅列表。
参数: search_string, price_min, price_max, bedrooms_min, bedrooms_max, bathrooms_min, property_type, district, region, sort_order, page, rows
示例提示:
- “惠灵顿价值80万美元以下的三居室房屋”
- “奥克兰待售公寓,带2间以上浴室”
get_list
获取特定列表的完整详细信息,包括描述、照片、卖家信息和出价历史。
参数: listing_id (必填)
示例提示:
- “显示第一个列表的完整细节”
- “获取有关列表5858861442的更多信息”
get_类别
浏览Trade Me的类别树,发现类别编号,以便进行更有针对性的搜索。
参数: category_number (可选--顶级类别省略)
示例提示:
- “Trade Me有哪些类别?”
- “显示电子产品下的子类别”
提示
- 新上市: 要求按最新优先排序的结果——该工具支持
StartDateDesc排序顺序,Claude可以按列表日期进行过滤。 - 分页: 每页显示25个结果。让克劳德“显示更多”或“下一页”继续浏览。
- 细化: 你可以通过对话来优化搜索——“更便宜的”、“只在奥克兰”、“只有使用过的条件”。
- 跨类别: 你不需要知道某样东西在哪个Trade Me部分。只需描述你想要什么。
项目结构
src/
index.ts — MCP server setup and tool registration
api.ts — Trade Me API client
formatters.ts — Response formatting (JSON → readable text)
tools/
search.ts — search_trademe tool
motors.ts — search_motors tool
property.ts — search_property tool
listing.ts — get_listing tool
categories.ts — get_categories tool