内容
# @llmintel/mcp
一款 [MCP](https://modelcontextprotocol.io) 服务器，用于告诉您的代码代理某个模型 ID 是否安全使用。
大型语言模型（LLM）是在世界的快照上训练的，并且会在停止响应后自信地在您的代码中写入 `gpt-4-32k`。该服务器为代理提供了一个实时查询，判断模型是否已弃用以及何时停止工作。它还会返回替代模型。答案在 OpenAI、Anthropic、Azure AI Foundry、AWS Bedrock、Google 和 Cohere 等提供商中规范化，并从每个提供商自己的弃用页面解析。
无需 API 密钥，无需注册。该目录是公开的。
[](https://cursor.com/en/install-mcp?name=llmintel&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBsbG1pbnRlbC9tY3AiXX0%3D)
[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522llmintel%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540llmintel%252Fmcp%2522%255D%257D)
## 安装
将其添加到任何 MCP 主机。软件包通过 `npx` 直接从 npm 运行。
### Cursor
在 `.cursor/mcp.json` 中：
```json
{
"mcpServers": {
"llmintel": {
"command": "npx",
"args": ["-y", "@llmintel/mcp"]
}
}
}
```
### Claude Code
```bash
claude mcp add llmintel -- npx -y @llmintel/mcp
```
### Claude Desktop
与上面的 Cursor 块相同，位于 `claude_desktop_config.json` 中。
### 主机端点（无需安装）
同一五个工具通过 Streamable HTTP 在 `https://llmintel.ai/v1/mcp` 上提供。接受 URL 的主机不需要 Node 和包：
```json
{
"mcpServers": {
"llmintel": {
"url": "https://llmintel.ai/v1/mcp"
}
}
}
```
该端点是无状态的，只读的。它从 npm 包查询相同的目录。
## 工具
| 工具 | 返回值 |
| --- | --- |
| `check_model` | 检查模型 ID 是否安全使用：生命周期状态、退休截止日期（天）、替代模型和来源链接。 |
| `list_retiring_models` | 未来 90 天内哪些模型会失效。过期模型优先显示，然后是即将到来的模型。 |
| `suggest_replacement` | 提供商推荐的替代模型。如果没有发布替代模型，则默认为同一提供商的活跃模型。 |
| `search_models` | 按提供商和生命周期状态筛选的目录搜索。 |
| `recent_lifecycle_changes` | 跨所有提供商的变更日志，用于回答“本月哪些模型已弃用”等问题。 |
### 示例
> **您：** 在我们发布之前，请检查 `src/agents/` 中的模型 ID。
代理调用 `check_model` 并得到：
```
不要使用 — 该模型已弃用；API 调用失败。
"claude-sonnet-4-20250514" 解析为跟踪的模型 anthropic/claude-sonnet-4-20250514。
模型：claude-sonnet-4-20250514（anthropic/claude-sonnet-4-20250514）
提供商：anthropic
生命周期状态：已弃用 — 已弃用；调用失败
弃用时间：2026-04-14（105 天前）
退休时间：2026-06-15（43 天前）
提供商未指定替代模型。使用 suggest_replacement 获取选项。
定价/限制：$3/1M 输入 · $15/1M 输出
来源：https://docs.anthropic.com/en/docs/about-claude/model-deprecations
提供商自己的术语：“已弃用”
```
由于模型无法可靠地判断 `2026-07-30` 是否临近，因此始终以天为单位显示截止日期。
## 设计说明
查找失败永远不是安全性的结论。如果目录无法访问，工具会返回 MCP 错误并说明原因。读取网络故障作为“未找到弃用”信息的代理可能会愉快地发布已弃用的模型 ID。未跟踪的模型也会得到相同的处理：它返回“不在目录中，请与提供商验证”，而不是“确定”。
传递代码中字面上的字符串（`gpt-4o`、`anthropic/claude-opus-4-1`、`azure/gpt-4o`）并解析为规范的跟踪模型。
当提供商自己的弃用通知指定继任者时，就是您得到的结果。否则，同一提供商的活动模型的备用列表被标记为候选项，以便代理可以区分两者。
任何超过其退休日期的模型现在都已损坏，因此它有自己的标题，而不是放在“即将退休”中。
## 配置
两个变量都是可选的。
| 变量 | 默认值 | 用途 |
| --- | --- | --- |
| `LLMINTEL_API_KEY` | 无 | 提高速率限制预算。目录本身是公开的，因此您不需要此项。 |
| `LLMINTEL_BASE_URL` | `https://llmintel.ai` | 指向自托管或暂存目录。 |
匿名调用者每分钟限 30 次请求/每 IP，足够交互式代理使用。
## 数据来源
每个记录都链接到其解析的提供商页面，并保留提供商的字面生命周期术语（`sourceTerm`），因此可以审计规范决策。在发布前，变更会经过人工验证队列。收集器新鲜度公开于 [`/v1/status`](https://llmintel.ai/v1/status)。
相同的数据作为一个普通的 REST API 提供，也无需密钥。请参阅 [llmintel.ai/docs](https://llmintel.ai/docs)。
## 开发
```bash
pnpm --filter @llmintel/mcp build
pnpm exec vitest run packages/mcp # 协议级别的测试，针对伪造目录
# 在实时目录上驱动编译后的二进制文件
pnpm --filter @llmintel/mcp smoke
LLMINTEL_BASE_URL=http://localhost:3000 pnpm --filter @llmintel/mcp smoke
```
## 许可证
MIT © LLMIntel
