MCP Server Example
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Server Example Echo 'Hello, MCP!'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP Server Example
This repository contains an implementation of a Model Context Protocol (MCP) server for educational purposes. This code demonstrates how to build a functional MCP server that can integrate with various LLM clients.
What is MCP?
MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications - it provides a standardized way to connect AI models to different data sources and tools.

Key Benefits
A growing list of pre-built integrations that your LLM can directly plug into
Flexibility to switch between LLM providers and vendors
Best practices for securing your data within your infrastructure
Related MCP server: MCP Tool
Architecture Overview
MCP follows a client-server architecture where a host application can connect to multiple servers:
MCP Hosts: Programs like Claude Desktop, IDEs, or AI tools that want to access data through MCP
MCP Clients: Protocol clients that maintain 1:1 connections with servers
MCP Servers: Lightweight programs that expose specific capabilities through the standardized Model Context Protocol
Data Sources: Both local (files, databases) and remote services (APIs) that MCP servers can access
Core MCP Concepts
MCP servers can provide three main types of capabilities:
Resources: File-like data that can be read by clients (like API responses or file contents)
Tools: Functions that can be called by the LLM (with user approval)
Prompts: Pre-written templates that help users accomplish specific tasks
System Requirements
Python 3.10 or higher
MCP SDK 1.2.0 or higher
uvpackage manager
Getting Started
Installing uv Package Manager
On Windows:
powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"On MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shMake sure to restart your terminal afterwards to ensure that the uv command gets picked up.
Project Setup
Create and initialize the project:
# Create a new directory for our project
uv init mcp-server
cd mcp-server
# Create virtual environment and activate it
uv venv
.venv\Scripts\activate # On Windows use: source .venv/bin/activate
# Install dependencies
uv add "mcp[cli]" httpxCreate the server implementation file
main.py
Running the Server
Start the MCP server:
uv run main.pyThe server will start and be ready to accept connections
Connecting to Claude Desktop
Install Claude Desktop from the official website
Configure Claude Desktop to use your MCP server:
Edit claude_desktop_config.json:
{
"mcpServers": {
"mcp-server": {
"command": "uv", # It's better to use the absolute path to the uv command
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/YOUR/mcp-server",
"run",
"main.py"
]
}
}
}Restart Claude Desktop
Troubleshooting
If your server isn't being picked up by Claude Desktop:
Check the configuration file path and permissions
Verify the absolute path in the configuration is correct
Ensure uv is properly installed and accessible
Check Claude Desktop logs for any error messages
Available Tools
1 toolget_documentationA
Search for and retrieve documentation from LlamaIndex or LangChain sites.
This tool searches for relevant documentation using Serper API and then scrapes
the content from the top results to provide comprehensive information.
Args:
query: Search query for documentation (e.g., "vector store", "chat models", "retrieval")
library: The library to search for ('llamaindex' or 'langchain')
max_results: Maximum number of documentation pages to retrieve (1-2, default 2)
Returns:
Formatted documentation content from the search results
Inputs: query (required), library (required), max_results. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusing it with others. The tool's purpose is clearly defined and distinct.
The single tool follows a consistent verb_noun pattern (get_documentation). Consistency is trivially maintained with one tool.
A single tool feels thin for a server, even if the tool is comprehensive. The server lacks the breadth typical of a well-scoped integration, making it borderline.
The tool fully covers its stated domain of retrieving documentation from LlamaIndex or LangChain. It provides appropriate parameters and returns comprehensive content, with no obvious gaps for a read-only documentation tool.
Maintenance
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.1162MIT
- AlicenseDqualityDmaintenanceA server built on mcp-framework that enables integration with Claude Desktop through the Model Context Protocol.11MIT
- AlicenseBqualityDmaintenanceAn educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server integrating with various LLM clients.2MIT
- AlicenseAqualityDmaintenanceA demonstration MCP server for local development and testing with Claude Desktop on WSL. Provides basic utility tools including greeting messages, echo functionality, and server information retrieval.3MIT