CSFloat MCP服务器
MCP(模型上下文协议)服务器,用于访问CSFloat CS2皮肤市场数据,并提供高级交易分析和磨损状况支持。
特性
- 按名称搜索皮肤:查找具有精确市场哈希名称的特定CS2皮肤
- 按武器类型搜索:使用def_index搜索特定武器的所有皮肤
- 自动磨损状态检测:从查询中解析磨损情况(例如,“AK-47现场测试”)
- 交易分析:使用SP(贴纸价格)计算显示高于/低于预测价格的百分比
- 价格和浮动过滤:按价格范围和浮动值筛选
- 浏览市场:使用高级筛选器浏览所有可用列表
- 获取房源详情:通过交易分析获取特定房源的详细信息
设置
- 安装依赖项:
pip install -r requirements.txt- 设置CSFloat API密钥:
export CSFLOAT_API_KEY="your_api_key_here"从CSFloat配置文件设置中获取API密钥。
- 测试服务器:
python test_server.py用法
运行MCP服务器:
python csfloat_mcp_server.py可用工具
search_skins
按确切名称和磨损情况搜索CS2皮肤。如果只提供武器名称,则自动重定向到武器搜索。
参数:
skin_name(必填):完整的皮肤名称和佩戴情况(例如,“AK-47 |红线(现场测试)”)limit:结果数量(最多50个,默认20个)sort_by:排序顺序(best_deal、lowest \_price、highest \_pice、lowest \_float、highest \_floot、most_recent、highest \_discount、expires_soon)min_price,max_price:价格范围(美元)min_float,max_float:浮点值范围(0.0-1.0)include_auctions:包括拍卖列表(默认值:False)
search_by_weapon
使用def_index搜索特定武器类型的所有皮肤。支持自动分析磨损状况。
参数:
weapon_name(必填):武器名称,可选择带有磨损情况(例如,“AK-47”、“经过AK-47现场测试”、“Karambit FN”)limit:结果数量(最多50个,默认20个)sort_by:排序顺序(best_deal、lowest \_price、highest \_pice、lowest \_float、highest \_floot、most_recent、highest \_discount、expires_soon)min_price,max_price:价格范围(美元)min_float,max_float:浮动值范围(0.0-1.0)-如果指定,则覆盖磨损状况include_auctions:包括拍卖列表(默认值:False)
get_listing_details
通过交易分析获取特定房源的详细信息。
参数:
listing_id(必填):列表的ID
browse_market
使用过滤器浏览一般市场。
参数:
page:分页页码(默认值0)limit:每页结果(最多50个,默认20个)sort_by:排序顺序min_price,max_price:价格范围过滤器
ask_clarifying_questions
获得模糊查询和搜索建议的帮助。
参数:
query(必填):您的一般查询或请求
get_wear_conditions_help
获取有关CS2皮肤磨损状况和正确格式化的信息。
磨损状态浮动范围
当检测到磨损情况时,服务器会自动应用适当的浮动范围:
- 新工厂(FN): 0.00 – 0.07
- 最小磨损(MW): 0.07 – 0.15
- 现场测试(FT): 0.15 – 0.37
- 穿着得体(WW): 0.37 – 0.44
- 战斗恐惧(BS): 0.44 – 1.00
例子
# Search for specific skin with exact name and wear condition
search_skins(skin_name="AK-47 | Redline (Field-Tested)", max_price=50, sort_by="best_deal")
# Search all AK-47 skins (any skin pattern)
search_by_weapon(weapon_name="AK-47", limit=10, sort_by="lowest_price")
# Search AK-47 skins with specific wear condition (auto-applies float range 0.15-0.37)
search_by_weapon(weapon_name="AK-47 Field-Tested", max_price=100, sort_by="best_deal")
# Search Karambit Factory New (auto-applies float range 0.00-0.07)
search_by_weapon(weapon_name="Karambit FN", sort_by="lowest_float")
# Get details for a specific listing with deal analysis
get_listing_details(listing_id="890602542927580927")
# Browse market sorted by best deals
browse_market(limit=10, sort_by="best_deal")交易分析功能
每个列表显示:
- 价格与预测:高于/低于CSFloat预测价格的百分比
- SP(贴纸价格):对于有贴纸的高价商品,显示您多付了贴纸价值的百分比
- 好交易检测:突出显示明显低于预测价格的房源
- 贴纸值:单个标签价格和标签总价值
