MCP SOP Server

You can query and retrieve Standard Operating Procedures in Italian with this MCP server. It uses semantic search, category filtering, and guided SOP suggestions, all powered by fast vector storage and multilingual embeddings tailored for Italian text.

How to use

You interact with the server through an MCP client. Start the server and then issue natural language questions to search SOP content, get step-by-step guidance for specific situations, or browse SOPs by category. The system returns structured results that are easy to consume in downstream tools or LLMs.

How to install

Prerequisites: Python must be installed on your machine. You will create and activate a virtual environment, then install the required dependencies.

git clone https://github.com/dadapera/mcp-sop-server.git
cd mcp-sop-server

python -m venv venv

# On Windows
venv\Scripts\activate

# On macOS/Linux
source venv/bin/activate

pip install -r requirements.txt

# Create the SOP documents directory and organize your SOPs by category

Additional configuration and usage notes

You can run the MCP server locally or connect to it via an MCP client configuration. The server is designed to index SOP documents on first request and store embeddings in a fast vector store for quick retrieval.

If you are configuring a client to use this server, you can point it at a local stdio-based setup as shown in the example below. The server runs as a local process and accepts commands from the MCP client.

{
  "type": "stdio",
  "name": "sop",
  "command": "python",
  "args": ["/path/to/your/mcp-sop-server/main.py"],
  "cwd": "/path/to/your/mcp-sop-server"
}

Notes on document handling and features

The server can process multiple SOP formats, including PDF and DOCX, and uses multilingual embeddings for Italian language support. It provides semantic search, category filtering, and guidance tailored to specific situations. Documents are indexed on first request to ensure quick startup and responsiveness in ongoing usage.

Available tools

search_sop_documents

Search SOP content using natural language queries with optional category filtering and a max results limit.

get_sop_guidance

Provide situation-based guidance drawn from SOP documents, optionally focused on a specific category.

list_sop_categories

List all available SOP categories along with collection statistics.

get_sop_by_category

Retrieve all SOPs contained within a specified category.

refresh_sop_database

Refresh the document database to incorporate updates to SOP files.

get_server_status

Return current server status and statistics.