侦察员MCP模型
](https://www.npmjs.com/package/model-scout-mcp) 
MCP(模型上下文协议)服务器,用于在具有实时定价和功能的提供商之间发现、比较和选择LLM模型。
支持stdio和 可流式传输的HTTP 运输。
问题陈述
大型语言模型通常对以下方面有过时的知识:
- 新发布的型号及其确切名称/ID
- 当前代币定价
- 模型功能和支持的功能
此MCP服务器通过提供对模型目录和智能搜索/比较工具的实时访问来解决这些问题。
当前状态
阶段: ✅ 已实施和测试
提供商支持:
- ✅ 开放路由 -目前支持(来自50多家供应商的100多种型号)
- 🔄 未来:可能会添加其他提供商
备注OpenRouter目前是唯一受支持的提供商,因为它提供了对模型定价和功能的全面编程访问。并非所有模型提供商都提供用于成本检查的API,这使得OpenRouter成为此用例的理想聚合器。
文档
工具架构(2个工具)
1. get_model
按ID直接查找特定模型。返回包括API终结点信息在内的完整详细信息。
2. consider_models
用于根据用户需求探索、比较和分析模型的灵活工具。手柄:
- 过滤和搜索
- 模型比较
- 成本分析和预测
- 带有权衡的建议
设计理念:一个查找工具,一个考虑工具。这 consider_models 该工具根据请求调整其行为,可以简单到列出免费模型,也可以复杂到具有成本预测的多因素决策分析。
主要特点
模型发现
- 按自然语言搜索(“廉价教学模式”)
- 按能力(愿景、工具、推理)过滤
- 按定价、上下文长度、提供商筛选
- 按各种标准(价格、上下文、新旧程度)排序
成本优化
- 计算工作负载的估计成本
- 查找符合要求的最便宜型号
- 比较多个型号的定价
- 确定具有成本效益的替代方案
智能推荐
- 基于用例的建议
- 权衡分析(成本与能力)
- 备选建议
- 根据需求进行个性化设置
用例
LLM应用
- 接地:获取当前型号名称和ID
- 成本规划:部署前估计API成本
- 优化:寻找具有类似功能的更便宜的替代品
- 发现:查找符合特定条件的新型号
查询示例
"Find me a cheap instructional model"
→ search_models or find_cheapest with filters
"What's the latest GPT-4 variant?"
→ list_models filtered by provider, sorted by date
"Compare Claude Opus vs Sonnet pricing"
→ compare_models with both IDs
"I need a model with vision for under $1 per million tokens"
→ search_models or list_models with modality and price filters
"What will it cost to process 100K tokens with GPT-4?"
→ calculate_cost with model ID and token counts
"Is there a cheaper alternative to Claude Opus?"
→ find_alternatives optimized for cost技术方法
数据源
- OpenRouter API:
https://openrouter.ai/api/v1/models - 通过承载令牌进行身份验证
- 返回包含定价和功能的全面型号目录
缓存策略
- 缓存模型列表10分钟(可配置)
- 内存过滤和搜索
force_refresh绕过缓存的参数
实施阶段
第一阶段(MVP):核心工具
list_models,get_model,calculate_cost
第2阶段(增强型):情报
search_models,compare_models,find_cheapest
第三阶段(高级):人工智能驱动
recommend_model,find_alternatives
API密钥设置
创建一个 .env 文件包含:
OPENROUTER_API_KEY=sk-or-v1-...从以下位置获取API密钥:https://openrouter.ai/keys
提供商详细信息
开放路由
OpenRouter聚合了来自多个提供商的模型:
- OpenAI(GPT-4、GPT-3.5等)
- 拟人(克劳德模型)
- Meta(美洲驼模型)
- 谷歌(双子座,PaLM)
- 米斯特拉尔AI
- 50多家供应商
API文档: https://openrouter.ai/docs/api/reference/overview
未来的增强功能
- 历史定价跟踪
- 性能基准集成
- 模型弃用警报
- 额外的提供商支持
- 基于使用模式的成本预测
- 批量比较工具
- 自定义过滤DSL
安装
先决条件
- Node.js 18或更高版本
- OpenRouter API密钥(在这里买一个)
选项1:通过npm安装(推荐)
全局安装或与npx一起使用:
# Install globally
npm install -g model-scout-mcp
# Or use with npx (no installation needed)
npx model-scout-mcp选项2:从源代码安装
# Clone the repository
git clone https://github.com/danielrosehill/Model-Scout-MCP.git
cd Model-Scout-MCP
# Install dependencies
npm install
# Link for local testing (optional)
npm link
# Test the server
npm test # or: node test-server.js
# Test MCP protocol (optional)
./test-mcp-server.sh配置
克劳德桌面(stdio传输)
添加到MCP设置文件中:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json - 视窗:
%APPDATA%\Claude\claude_desktop_config.json
使用npx(推荐)
{
"mcpServers": {
"model-scout": {
"command": "npx",
"args": ["-y", "model-scout-mcp"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}使用全局安装
{
"mcpServers": {
"model-scout": {
"command": "model-scout-mcp",
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}从源头使用
{
"mcpServers": {
"model-scout": {
"command": "node",
"args": ["/absolute/path/to/Model-Scout-MCP/index.js"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here"
}
}
}
}备注:替换 your-api-key-here 使用来自的实际OpenRouter API密钥https://openrouter.ai/keys
HTTP传输(流式HTTP)
对于支持基于HTTP的MCP连接的客户端,您可以在HTTP模式下运行服务器:
# Start the HTTP server
MCP_TRANSPORT=http OPENROUTER_API_KEY=your-key node index.js
# Or with npm scripts
npm run start:http环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
OPENROUTER_API_KEY | 您的OpenRouter API密钥(必需) | - |
MCP_TRANSPORT | 运输方式: stdio 或 http | stdio |
MCP_PORT | HTTP服务器端口(仅限HTTP模式) | 3000 |
MCP_HOST | HTTP服务器主机(仅限HTTP模式) | 127.0.0.1 |
HTTP端点
在HTTP模式下运行时:
- MCP端点:
POST/GET http://127.0.0.1:3000/mcp - 健康检查:
GET http://127.0.0.1:3000/health
MCP客户端配置(HTTP)
对于支持流式HTTP传输的MCP客户端:
{
"mcpServers": {
"model-scout": {
"url": "http://127.0.0.1:3000/mcp",
"transport": "streamable-http"
}
}
}贡献
欢迎投稿!请在GitHub上打开问题或PR。
许可证
MIT许可证-有关详细信息,请参阅许可证文件
作者
丹尼尔·罗斯希尔
- 网站: danielrosehill.com
- github: @丹尼尔·罗斯希尔
- 电子邮件:public@danielrosehill.com
