home / mcp / syv mcp tools mcp server

SyV MCP Tools MCP Server

MCP server with tools for the Subordinación y Valor project

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "kodexarg-syv-mcp-tools": {
      "command": "python",
      "args": [
        "mcp_server.py"
      ],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You run the SyV MCP Tools server to work with Markdown file metadata. It validates metadata against the project guidelines and retrieves metadata from Markdown files, helping you ensure consistency and extract useful data from your docs.

How to use

You connect to the MCP server using a client that supports the MCP protocol. The server exposes two main capabilities: validating Markdown metadata and retrieving Markdown metadata. Use these tools to ensure your *.md files adhere to the metadata guide and to extract metadata for automation, dashboards, or documentation workflows.

How to install

Prerequisites: Python 3.12 or newer.

# Install dependencies
uv sync

Additional notes

Configuration involves creating a .env file at the project root with your API key for Claude access. Use the following variable:

ANTHROPIC_API_KEY=tu_api_key_aquí

Usage examples you can run locally

To start the MCP server locally, you run the Python script directly. You may also start a Windows batch script if you are on Windows.

# Run the MCP server
python mcp_server.py
```

```bash
# Windows: run the batch script
mcp_server.bat

Available tools

validar_metadatos_markdown

Validates Markdown metadata files (*.md) against the project metadata guidelines. Returns a JSON object with status and an error message if validation fails.

obtener_metadatos_markdown

Retrieves metadata from Markdown files and returns a JSON object containing the metadata fields or an error.