内容
# mcp-jinaai-reader
---
## ⚠️ 注意
**该仓库已不再维护。**
该工具的功能现已在 [mcp-omnisearch](https://github.com/spences10/mcp-omnisearch) 中可用,它将多个 MCP 工具合并为一个统一的软件包。
请改用 [mcp-omnisearch](https://github.com/spences10/mcp-omnisearch)。
---
一个模型上下文协议(MCP)服务器,用于将 Jina.ai 的 Reader API 与大型语言模型(LLM)集成。该服务器提供高效、全面的网页内容提取能力,针对文档和网页内容分析进行了优化。
<a href="https://glama.ai/mcp/servers/a75afsx9cx">
<img width="380" height="200" src="https://glama.ai/mcp/servers/a75afsx9cx/badge" />
</a>
## 功能特点
- 📚 通过 Jina.ai Reader API 实现高级网页内容提取
- 🚀 快速高效的内容检索
- 📄 完整的文本提取,保留结构
- 🔄 为 LLM 优化的干净格式
- 🌐 支持包括文档在内的各种内容类型
- 🏗️ 基于模型上下文协议构建
## 配置
该服务器需要通过您的 MCP 客户端进行配置。以下是不同环境的示例:
### Cline 配置
将以下内容添加到您的 Cline MCP 设置中:
```json
{
"mcpServers": {
"jinaai-reader": {
"command": "node",
"args": ["-y", "mcp-jinaai-reader"],
"env": {
"JINAAI_API_KEY": "您的 Jina.ai API 密钥"
}
}
}
}
```
### 使用 WSL 的 Claude Desktop 配置
对于 WSL 环境,请将以下内容添加到您的 Claude Desktop 配置中:
```json
{
"mcpServers": {
"jinaai-reader": {
"command": "wsl.exe",
"args": [
"bash",
"-c",
"JINAAI_API_KEY=您的 Jina.ai API 密钥 npx mcp-jinaai-reader"
]
}
}
}
```
### 环境变量
服务器需要以下环境变量:
- `JINAAI_API_KEY`: 您的 Jina.ai API 密钥(必填)
## API
服务器实现了一个具有可配置参数的 MCP 工具:
### read_url
使用 Jina.ai Reader 将任何 URL 转换为 LLM 友好的文本。
参数:
- `url`(字符串,必填):要处理的 URL
- `no_cache`(布尔值,可选):绕过缓存以获取最新结果。默认为 `false`
- `format`(字符串,可选):响应格式("json" 或 "stream")。默认为 "json"
- `timeout`(数字,可选):等待网页加载的最长时间(秒)
- `target_selector`(字符串,可选):聚焦于特定元素的 CSS 选择器
- `wait_for_selector`(字符串,可选):等待特定元素的 CSS 选择器
- `remove_selector`(字符串,可选):排除特定元素的 CSS 选择器
- `with_links_summary`(布尔值,可选):在响应结尾收集所有链接
- `with_images_summary`(布尔值,可选):在响应结尾收集所有图片
- `with_generated_alt`(布尔值,可选):为缺少标题的图片添加替代文本
- `with_iframe`(布尔值,可选):在响应中包含 iframe 内容
## 开发
### 设置
1. 克隆仓库
2. 安装依赖:
```bash
npm install
```
3. 构建项目:
```bash
npm run build
```
4. 在开发模式下运行:
```bash
npm run dev
```
### 发布
1. 更新 `package.json` 中的版本号
2. 构建项目:
```bash
npm run build
```
3. 发布到 npm:
```bash
npm publish
```
## 贡献
欢迎贡献!请随时提交拉取请求。
## 许可证
MIT 许可证 - 参见 [LICENSE](LICENSE) 文件了解详情。
## 致谢
- 基于 [模型上下文协议](https://github.com/modelcontextprotocol)
- 由 [Jina.ai Reader API](https://jina.ai) 提供支持