网页内容提取服务

JinaAI MCP服务器

由Jina.ai阅读器API提供支持的智能网络阅读器工具，作为生产级模型上下文协议（MCP）服务器提供。

模型上下文协议（MCP）服务器为 Jina.ai阅读器API。使LLM和AI代理能够以编程方式读取、处理和理解来自任何网页的内容。

建立在 cyanheads/mcp-ts-template，此服务器遵循模块化架构，具有强大的错误处理、日志记录和安全功能。

🚀 核心能力：Jina人工智能工具🛠️

该服务器为您的AI配备了一个专门的工具来与网络内容进行交互：

目录

概述

JinaAI MCP服务器充当桥梁，允许理解模型上下文协议（MCP）的应用程序（如高级AI助手、IDE扩展或自定义研究工具）直接有效地与web内容交互。

您的代理可以利用此服务器来：

• 自动化信息收集：以编程方式阅读文章、文档和其他网络内容。
• 获得更深入的理解：无需离开宿主应用程序，即可从任何URL访问干净、LLM就绪的文本。
• 将Web内容集成到AI工作流中：使LLM能够进行研究、总结文章，并将实时网络数据纳入他们的回复中。

开发者说明：此存储库包括 .微规则 该文件作为LLM编码代理的开发人员备忘单，可快速参考代码库模式、文件位置和代码片段。

特性

核心公用设施

利用 mcp-ts-template:

• 日志记录：结构化、可配置的日志记录，带有敏感数据编辑功能。
• 错误处理：集中错误处理和标准化错误类型(McpError).
• 配置：环境变量加载(dotenv)使用Zod进行验证。
• 输入验证：用途 zod 对于所有工具输入模式。
• 请求上下文：通过唯一的请求ID进行端到端操作跟踪。
• 类型安全：由TypeScript和Zod模式强制执行。
• HTTP传输：使用高性能HTTP服务器 你好，具有会话管理和身份验证支持。
• 认证：支持JWT和OAuth 2.1的强大身份验证层。
• 可观测性：集成 开放遥测 用于分布式跟踪和度量。

Jina AI集成

• 智能内容提取：利用Jina的 readerlm-v2 引擎解析主要内容并删除样板。
• 多种格式：支持Markdown、HTML或纯文本输出。
• 灵活的选项：控制包括链接、图像和使用缓存。

安装

先决条件

• Node.js（>=18.0.0）
• npm （附带Node.js）

MCP客户端设置

将以下内容添加到MCP客户端的配置文件中（例如。， cline_mcp_settings.json). 此配置使用 npx 运行服务器，如果还没有安装包，它将自动安装。 这 JINA_API_KEY 是服务器运行所必需的。

{
  "mcpServers": {
    "jinaai-mcp-server": {
      "command": "npx",
      "args": ["@cyanheads/jinaai-mcp-server"],
      "env": {
        "MCP_TRANSPORT_TYPE": "http",
        "MCP_HTTP_PORT": "3018",
        "JINA_API_KEY": "YOUR_JINA_API_KEY_HERE"
      }
    }
  }
}

来源

1. 克隆存储库：
   复制

   git clone https://github.com/cyanheads/jinaai-mcp-server.git
   cd jinaai-mcp-server
   

2. 安装依赖项：
   复制

   npm install
   

3. 构建项目：
   复制

   npm run build
   

配置

环境变量

使用环境变量配置服务器。为了地方发展，创建一个 .env 项目根目录下的文件。

项目结构

代码库遵循模块化结构 src/ 目录：

src/
├── index.ts              # Entry point: Initializes and starts the server
├── config/               # Configuration loading (env vars)
│   └── index.ts
├── mcp-server/           # Core MCP server logic and capability registration
│   ├── server.ts         # Server setup, tool registration
│   └── tools/            # MCP Tool implementations
│       └── jinaReader/   # The Jina AI Reader tool
└── utils/                # Common utility functions (logger, error handler, etc.)

要查看详细的文件树，请运行 npm run tree 或查看 docs/tree.md.

开发与测试

开发脚本

# Build the project (compile TS to JS in dist/)
npm run build

# Clean build artifacts and then rebuild the project
npm run rebuild

# Format code with Prettier
npm run format

测试

此项目使用 速度 用于单元和集成测试。

# Run all tests once
npm test

# Run tests in watch mode
npm run test:watch

# Run tests and generate a coverage report
npm run test:coverage

运行服务器

# Start the server using stdio (default)
npm run start:server

# Start the server using HTTP transport
npm run start:server:http

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 文件以获取详细信息。