Omni Server

by abhijithk1

154 downloads Not rated yet
GitHub

About

A MCP Server to get familiarize to Model Context Protocol

Explore

- πŸš€ MCP server implementation using Python
- πŸ“ Modular project structure with clear separation of prompts, tools, data, and resources
- βš™οΈ Easily configurable with .env and Poetry
- 🧠 Designed to integrate seamlessly with Claude Desktop

---

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Omni Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

- Python 3.8 or higher
- uv for dependency management

---

To run manually via terminal:

uv pip install -e .  # ensure it's installed
python main.py

Or if you're using a virtual environment:

.venv/Scripts/python.exe main.py

---

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "omni server": {
            "omni-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "omni-server": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

Omni Server is a Model Context Protocol (MCP) server designed to help developers familiarize themselves with the MCP framework. It serves as a foundational tool for understanding and implementing MCP-based applications.

---

Features

- πŸš€ MCP server implementation using Python
- πŸ“ Modular project structure with clear separation of prompts, tools, data, and resources
- βš™οΈ Easily configurable with .env and Poetry
- 🧠 Designed to integrate seamlessly with Claude Desktop

---

Project Structure

omni-server/
β”œβ”€β”€ data/           # Data files and datasets
β”œβ”€β”€ prompts/        # Prompt templates and related files
β”œβ”€β”€ resources/      # Static resources and assets
β”œβ”€β”€ tools/          # Utility scripts and tools
β”œβ”€β”€ utils/          # Helper functions and utilities
β”œβ”€β”€ .env            # Environment variable definitions
β”œβ”€β”€ .gitignore      # Git ignore rules
β”œβ”€β”€ .python-version # Python version specification
β”œβ”€β”€ README.md       # Project documentation
β”œβ”€β”€ main.py         # Main application entry point
β”œβ”€β”€ pyproject.toml  # Project metadata and dependencies
β”œβ”€β”€ server.py       # Server initialization and configuration
└── uv.lock         # Dependency lock file

---

Getting Started

Prerequisites

- Python 3.8 or higher
- uv for dependency management

---

Installation

1. Clone the repository:

git clone https://github.com/abhijithk1/omni-server.git
cd omni-server

2. Install dependencies using uv:

```bash
uv venv
uv pip install -r requirements.txt # if using requirements.txt

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.