@sakupi01/mcp-saba

An MCP Server for blog search functionality developed /w Deno!

Available as Local Package and Remote Server.

• Docker Image: sakupi/mcp-saba
• Package: @sakupi01/mcp-saba
• Remote Server: https://mcp.sakupi01.com/mcp

How to

Install from JSR

# Deno
deno add @sakupi01/mcp-saba

# npm
npx jsr add @sakupi01/mcp-saba

# yarn
yarn dlx jsr add @sakupi01/mcp-saba

# pnpm
pnpm dlx jsr add @sakupi01/mcp-saba

Usage

Running the MCP Server Locally

import { runServer } from "@sakupi01/mcp-saba/mod";

// Start server with default settings (port 8000)
runServer();

// Or with custom configuration
runServer({
  port: 3000
});

Using the Remote MCP Server

You can use the already deployed MCP server as an API endpoint:

https://mcp.sakupi01.com/mcp

Using in VS Code

You can use mcp-saba in VS Code with the following methods:

Option 1: Add to VS Code settings.json

Add the following to your VS Code settings.json:

"mcp": {
  "servers": {
    "sakupi01-mcp": {
      "type": "http",
      "url": "https://mcp.sakupi01.com/mcp"
    }
  }
}

Option 2: Using Local Server

1. Start the local MCP server in a terminal:

   # Using docker image
   docker run -i --rm sakupi/mcp-saba
   
   # Using npx
   npx @sakupi01/mcp-saba
   
   # Or if installed globally
   mcp-saba

2. Open VS Code Command Palette (Cmd+Shift+P or Ctrl+Shift+P)

3. Run "MCP: Add Server..."

4. Enter http://localhost:8000/mcp as the server URL

Option 3: Using Docker Image

To use Docker Image, add the following style of setting to your Host:. For example, claude_desktop_config.json:

{
  "mcpServers": {
    "@sakupi01.com/mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "sakupi/mcp-saba"
      ]
    }
  }
}

Available Tools

Blog Search Tool (sakupi01_search_blogs)

Search blog posts by title, description, URL, tags, and content.
Multiple keywords separated by spaces are treated as OR conditions.

Parameters

• query: Search query (required, 1-100 characters)
• limit: Maximum number of results to return (optional, default: 10, max: 100)
• offset: Result offset (optional, default: 0)
• order: Sort order (optional, "desc" (newest first) or "asc" (oldest first), default: "desc")

Example Response

{
  "total": 1,
  "offset": 0,
  "limit": 2,
  "order": "desc",
  "query": {
    "original": "Test",
    "keywords": ["test"],
    "exactPhrases": []
  },
  "results": [
    {
      "title": "🎄Open UI Advent Calendar: Day 11 / Customizable Select Element",
      "pubDate": "2024-12-11T00:00:00.000Z",
      "description": "Customizable Select Element specifications...",
      "link": "https://blog.sakupi01.com/dev/articles/2024-openui-advent-11/",
      "content": "Test content...",
      "tags": ["openui", "advent calendar"],
      "score": 2
    }
  ]
}

Running Tests

Install dependencies and run tests:

deno test

Changelog

See the Releases page.

License

Released under the MIT License. See the LICENSE file for details.