V Language MCP Server

A comprehensive Model Context Protocol (MCP) server that provides LLMs with extensive knowledge about the V programming language, including documentation, code examples, standard library reference, and syntax explanations.

Features

📚 Documentation Access

• Full V documentation: Access the complete V programming language documentation

• Section-specific queries: Get detailed information about specific language features

• Search functionality: Search through documentation for specific topics

💡 Code Examples

• Example browser: Browse through hundreds of V code examples

• Code retrieval: Get complete source code for any example

• Pattern search: Search through examples for specific coding patterns

🔧 Standard Library Reference

• Module listing: Browse all available V standard library modules

• Module details: Get comprehensive information about specific modules

• File listings: See what functions and types are available in each module

🎯 Syntax Explanations

• Feature explanations: Detailed explanations of V language features

• Code examples: Practical examples for each concept

• Quick reference: Fast access to common syntax patterns

🚀 Code Execution (Planned)

• Code validation: Check V code syntax and semantics

• Example execution: Run V examples and see their output

• Interactive learning: Learn by running and modifying code

Installation

Prerequisites

• Python 3.10+

• Access to the V language repository (this project should be run from within the V repo or with V_REPO_PATH configured)

Setup

1. Clone or navigate to the V repository

2. Navigate to the MCP server directory:

   cd v-mcp-server

3. Install dependencies:

   pip install -r requirements.txt

4. (Optional) Configure the V repository path:

   export V_REPO_PATH="/path/to/v/repository"

   If not set, the server assumes it's running from within the V repository.

Usage

Starting the Server

STDIO Mode (Default)

python main.py

HTTP Mode

python main.py --transport http --host 127.0.0.1 --port 8000

SSE Mode

python main.py --transport sse --host 127.0.0.1 --port 8000

Available Tools

Documentation Tools

• get_v_documentation([section]) - Get V documentation, optionally for a specific section

• search_v_docs(query) - Search through V documentation for specific topics

Example Tools

• list_v_examples() - List all available V code examples

• get_v_example(name) - Get the complete source code for a specific example

• search_v_examples(query) - Search through example code for patterns

Standard Library Tools

• list_v_stdlib_modules() - List all V standard library modules

• get_v_module_info(module_name) - Get detailed information about a specific module

Language Reference Tools

• explain_v_syntax(feature) - Get detailed explanation of V language features

• get_v_quick_reference() - Get a quick reference guide for V basics

MCP Client Integration

Using with Claude Desktop

Add this to your Claude Desktop configuration:

{
  "mcpServers": {
    "v-language": {
      "command": "python",
      "args": ["/path/to/v-mcp-server/main.py"],
      "env": {
        "V_REPO_PATH": "/path/to/v/repository"
      }
    }
  }
}

Using with Other MCP Clients

The server supports all standard MCP transports:

• STDIO: Best for local development and testing

• HTTP: Suitable for web applications and remote access

• SSE: Good for real-time applications

Examples

Getting Started with V

User: How do I get started with V programming?
Assistant: Let me help you get started with V programming. First, let me get the basic documentation overview.

[get_v_documentation] -> Returns overview of V documentation sections

Then let me get the quick reference guide to show you the basics.

[get_v_quick_reference] -> Returns quick reference with essential syntax

Finding Code Examples

User: Show me how to work with arrays in V
Assistant: I'll show you how arrays work in V by looking at examples and documentation.

[explain_v_syntax("arrays")] -> Returns detailed explanation of V arrays

Let me also find some practical examples.

[search_v_examples("array")] -> Returns examples that use arrays

Standard Library Exploration

User: What modules are available in V's standard library?
Assistant: Let me show you the available modules in V's standard library.

[list_v_stdlib_modules] -> Returns list of all stdlib modules

If you're interested in a specific module, I can provide more details.

[get_v_module_info("os")] -> Returns detailed info about the os module

Learning Specific Features

User: How do structs work in V?
Assistant: Let me explain V structs with examples.

[explain_v_syntax("structs")] -> Returns comprehensive explanation of structs

Let me also show you a practical example.

[get_v_example("struct")] -> Returns example code using structs

Configuration

Environment Variables

• V_REPO_PATH: Path to the V language repository (defaults to parent directory)

Server Options

• --transport: Transport protocol (stdio, http, sse)

• --host: Host address (for HTTP/SSE transports)

• --port: Port number (for HTTP/SSE transports)

• --path: URL path (for HTTP transport)

Architecture

The MCP server is built with the following components:

VDocumentationServer Class

• Handles file system operations within the V repository

• Caches documentation and example data for performance

• Provides search functionality across documentation and code

MCP Tools

Each tool corresponds to a specific functionality:

• Documentation tools: Access and search V language documentation

• Example tools: Browse and retrieve code examples

• Standard library tools: Explore V's standard library modules

• Syntax tools: Explain language features and provide quick reference

FastMCP Framework

Built on the FastMCP library, providing:

• Multiple transport support: STDIO, HTTP, SSE

• Type safety: Full type annotations and validation

• Performance: Efficient caching and search algorithms

• Extensibility: Easy to add new tools and features

Development

Adding New Tools

To add a new tool, create a function decorated with @mcp.tool:

@mcp.tool
def new_tool_name(param1: str, param2: int) -> str:
    """Tool description."""
    # Implementation
    return result

Extending Functionality

The server can be extended by:

• Adding new tools for specific V features

• Implementing code execution capabilities

• Adding integration with V's compiler

• Creating interactive tutorials

Testing

Run tests with pytest:

pytest tests/

License

MIT

Related Projects

• V Programming Language - The main V language repository

• FastMCP - The MCP framework used by this server

• v-analyzer - V language server for IDE support