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/

Contributing

Contributions are welcome! Areas for improvement:

Add more detailed syntax explanations
Implement code execution and validation
Add support for V's package ecosystem
Create interactive learning modules
Add performance benchmarks and comparisons

License

This project is part of the V programming language ecosystem. See the main V repository for licensing information.

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