https://github.com/ironystock/mcp-multiutil
MCP multi-utility server with libSQL storage - provides key-val, vector-store, RAG, embeddings, and more
https://github.com/ironystock/mcp-multiutil
libsql mcp mcp-go
Last synced: 26 days ago
JSON representation
MCP multi-utility server with libSQL storage - provides key-val, vector-store, RAG, embeddings, and more
- Host: GitHub
- URL: https://github.com/ironystock/mcp-multiutil
- Owner: ironystock
- License: mit
- Created: 2025-12-04T04:25:04.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2025-12-04T04:25:13.000Z (2 months ago)
- Last Synced: 2026-01-12T00:48:14.564Z (29 days ago)
- Topics: libsql, mcp, mcp-go
- Language: Go
- Homepage:
- Size: 12.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# mcp-multiutil
A Model Context Protocol (MCP) server providing multiple utility tools powered by libSQL for persistent storage.
## Overview
mcp-multiutil is a stdio-based MCP server that exposes a collection of useful tools for AI agents and chat applications. It leverages libSQL for efficient, persistent storage with in-memory operation for fast performance.
## Features
### Tools
- **key-val** - Simple key-value storage with CRUD operations
- **vector-store** - Store and query vector embeddings with metadata
- **rag** - Retrieval-augmented generation using stored documents and vectors
- **embedding** - Generate and store text embeddings
- **txt-to-json** - Convert text to structured JSON with schema inference
- **txt-to-toon** - Convert text to cartoon/ASCII art representation
- **store-md** - Store markdown documents with metadata
- **token-count** - Count tokens in text
- **tokenize** - Split text into tokens
- **store-context** - Store conversation context for retrieval
## Installation
```bash
go install github.com/ironystock/mcp-multiutil@latest
```
## Usage
The server communicates over stdio and is designed to be used with MCP-compatible clients.
```bash
mcp-multiutil
```
### Configuration
The server uses a local libSQL database file (`multiutil.db` by default) that is loaded into memory on startup and persisted to disk on shutdown.
## Development
```bash
# Clone the repository
git clone https://github.com/ironystock/mcp-multiutil.git
cd mcp-multiutil
# Install dependencies
go mod download
# Build
go build -o mcp-multiutil .
# Run
./mcp-multiutil
```
## Architecture
- **Storage Layer**: libSQL with in-memory operation and disk persistence
- **Config Layer**: Centralized tool definitions, descriptions, and schemas
- **Tools Layer**: Individual tool handlers for each capability
- **MCP Server**: stdio transport with graceful shutdown
## License
MIT License - see [LICENSE](LICENSE) for details.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.