Omni Server

Omni Server

By abhijithk1 GitHub

A MCP Server to get familiarize to Model Context Protocol

Overview

what is Omni Server?

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.

how to use Omni Server?

To use Omni Server, clone the repository from GitHub, install the necessary dependencies, and run the server using Python. Configuration for integration with Claude Desktop is also provided.

key features of Omni Server?

  • 🚀 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

use cases of Omni Server?

  1. Developing applications that utilize the Model Context Protocol.
  2. Testing and experimenting with MCP-based functionalities.
  3. Integrating with Claude Desktop for enhanced capabilities.

FAQ from Omni Server?

  • What is the Model Context Protocol?

The Model Context Protocol is a framework for building applications that can interact with various models in a standardized way.

  • How do I install Omni Server?

You can install Omni Server by cloning the repository and using the provided installation instructions in the README.

  • Is Omni Server free to use?

Yes! Omni Server is open-source and free to use.

Content

Omni Server

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
  1. Install dependencies using uv:
uv venv
uv pip install -r requirements.txt  # if using requirements.txt

# or, better:
uv pip install -e .  # if pyproject.toml is used
  1. Activate the virtual environment (if needed):
source .venv/bin/activate  # macOS/Linux
.venv\Scripts\activate     # Windows
  1. Create a .env file (if required) with any necessary environment variables.

Dependencies

All required packages are defined in pyproject.toml. You can install them using:

uv pip install -e .

Running the Server

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

🧩 Integrating with Claude Desktop

To use this server with Claude Desktop, configure your claude_desktop_config.json like so:

{
  "mcpServers": {
    "omni_server": {
      "command": "<PATH TO PROJECT>/.venv/Scripts/python.exe",
      "args": [
        "<PATH TO PROJECT>/main.py"
      ],
      "cwd": "<PATH TO PROJECT>"
    }
  }
}

Make sure:

  • The path to the Python executable is correct
  • Your virtual environment (.venv) is created and installed via uv
  • Claude Desktop is configured to recognize the MCP server

Once that's done, Omni Server will run as an MCP-compatible backend inside Claude Desktop!

Contributing

Contributions are welcome! Fork the repository, make changes, and open a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

No tools information available.
No content found.