mcp -jina-java

This MCP server exposes a Jina Reader API-backed service that can search web content and fetch content from URLs. It offers two primary tools: readAndFetchContent and searchAndGetSERP. The readAndFetchContent tool accepts a URL and retrieves the content for you, which is useful when you need the full text or main content from a page. The searchAndGetSERP tool takes a keyword and queries the web to return a search engine results page (SERP) so you can explore relevant results before fetching or processing them. Use these tools to build conversational or retrieval-augmented experiences that rely on up-to-date web content provided through the Jina Reader API.

Prerequisites:

• Java Runtime Environment (JRE) or JDK installed and available on your system PATH
• Access to the jar file for mcp-server-jina-java-1.0-SNAPSHOT.jar

Installation steps:

1. Ensure Java is installed:
   • macOS/Linux: java -version
   • Windows: java -version
2. Obtain the MCP server jar (mcp-server-jina-java-1.0-SNAPSHOT.jar) and place it at a known path, e.g. /the path of the jar/mcp-server-jina-java-1.0-SNAPSHOT.jar
3. Create or edit your MCP configuration to point to the jar with the appropriate API key:

{
  "mcpServers": {
    "mcp-server-jina-java": {
      "command": "java",
      "args": [
        "-Dspring.ai.mcp.server.stdio=true",
        "-jar",
        "/the path of the jar/mcp-server-jina-java-1.0-SNAPSHOT.jar",
        "jina.api.api-key= Your jina key"
      ]
    }
  }
}

4. Start the MCP server using your preferred method (e.g., node-based launcher, uv, or your MCP orchestration). Example command to run the server directly (adjust as needed based on your environment):

java -Dspring.ai.mcp.server.stdio=true -jar /the path of the jar/mcp-server-jina-java-1.0-SNAPSHOT.jar jina.api.api-key=YourJinaKeyHere

5. Verify the server is running by checking logs or making a test request to the MCP server endpoint provided by your deployment.

Notes and tips:

• The server config uses the Jina Reader API, so you may need a valid Jina API key (provided as a parameter in the args). Ensure the key is kept secure and not exposed in version control.
• The available tools are readAndFetchContent (requires a URL) and searchAndGetSERP (requires a keyword). Integrate these into your application workflows to fetch content or present SERP results to users.
• If you encounter issues with connectivity or key authentication, double-check the jar path, Java version compatibility, and the API key syntax in the arguments.
• You can adjust Java system properties or add additional JVM options as needed, but maintain the required -jar path and jina.api.api-key argument.