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

Clone or navigate to the V repository
Navigate to the MCP server directory:
cd v-mcp-server
Install dependencies:
pip install -r requirements.txt
(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

V Programming Language - The main V language repository
FastMCP - The MCP framework used by this server
v-analyzer - V language server for IDE support