内容
# Keenable MCP
Keenable MCP 服务器,用于实时网络搜索和干净的 markdown 页面抓取,基于 [Keenable](https://keenable.ai) 网络索引。
- **托管端点:** `https://api.keenable.ai/mcp` (可流式传输的 HTTP)
- **工具:** `search_web_pages`,`fetch_page_content`
- **默认无密钥** (每小时 1,000 次请求)。可选的 API 密钥可以解除限制。
服务器是托管的,因此大多数客户端只需指向该 URL。对于仅接受 stdio `command` 的客户端(或配置路径),有一个薄的 npm 包装器(`@keenable/mcp`),它桥接到同一个端点。
## 工具
| 工具 | 描述 |
|---|---|
| `search_web_pages` | 实时网络搜索。参数:`query` (必填),以及可选的 `mode`、`site`、`published_after` / `published_before`、`acquired_after` / `acquired_before`。 |
| `fetch_page_content` | 获取一个 URL 并返回干净的 markdown。参数:`url` (必填),可选 `max_chars` (默认为 50000)。 |
## 使用它
### 远程(推荐)
支持远程 MCP 的客户端 — Cursor、Cline、VS Code 和 Claude Desktop 的自定义连接器 UI — 直接连接到 URL:
```json
{
"mcpServers": {
"keenable": {
"type": "streamable-http",
"url": "https://api.keenable.ai/mcp"
}
}
}
```
### Stdio(例如 Claude Desktop 的 `claude_desktop_config.json`)
对于仅接受 stdio `command` 的客户端或配置路径,请使用 `npx` 运行包装器:
```json
{
"mcpServers": {
"keenable": {
"command": "npx",
"args": ["-y", "@keenable/mcp"]
}
}
}
```
这就是您无密钥使用所需的一切。
## API 密钥(可选)
Keenable 默认无密钥。要解除每小时限制,请传递密钥。
远程:
```json
{
"mcpServers": {
"keenable": {
"type": "streamable-http",
"url": "https://api.keenable.ai/mcp",
"headers": { "X-API-Key": "YOUR_KEY" }
}
}
}
```
Stdio:
```json
{
"mcpServers": {
"keenable": {
"command": "npx",
"args": ["-y", "@keenable/mcp"],
"env": { "KEENABLE_API_KEY": "YOUR_KEY" }
}
}
}
```
## 包装器工作原理
`@keenable/mcp` 是一个小的 stdio 桥接器:它通过 Streamable HTTP 连接到托管服务器,并转发服务器公开的每个工具。该软件包中没有搜索逻辑;索引和工具位于 `https://api.keenable.ai/mcp` 后面。环境变量:
- `KEENABLE_API_KEY` — 可选的 API 密钥,作为 `X-API-Key` 发送。
- `KEENABLE_MCP_URL` — 覆盖端点(默认为 `https://api.keenable.ai/mcp`)。
## 链接
- 文档:https://docs.keenable.ai/mcp-server
- 网站:https://keenable.ai
- 注册表:[`ai.keenable/web-search`](https://registry.modelcontextprotocol.io/v0/servers?search=ai.keenable) (官方 MCP 注册表)
## 许可证
MIT