CustomMCPServer

Name: CustomMCPServer
Author: abhimvp

@abhimvp

Repository

About CustomMCPServer

build a custom MCP server in Python and connect that to an AI agent.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "CustomMCPServer": {
      "command": "uv",
      "args": [
        "init",
        "."
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is CustomMCPServer?

CustomMCPServer is a tutorial and code example for building a custom MCP (Model Context Protocol) server in Python. It demonstrates how to create a server that exposes data and functionality to LLM applications in a secure, standardized way, similar to a web API but designed for LLM interactions.

How to use CustomMCPServer?

Start by creating a uv‑managed project with uv init ., then add the MCP CLI dependency with uv add "mcp[cli]". Activate the virtual environment, run uv run mcp install main.py to install the server in Claude Desktop, and restart the Claude app to see the server appear. For an advanced server, add black and then run uv run mcp install adv_main.py.

Key features of CustomMCPServer

Expose data through Resources (load information into LLM context)
Provide functionality through Tools (execute code or produce side effects)
Define interaction patterns through Prompts (reusable LLM templates)
Built on the Python MCP Server SDK
Can be installed directly into Claude Desktop

Use cases of CustomMCPServer

Connect a database and ask Claude to create fake users automatically
Automate repetitive tasks by exposing custom tools to an AI agent
Build a secure, standardized interface between LLMs and your own data or APIs

FAQ from CustomMCPServer

What is MCP?

MCP (Model Context Protocol) lets you build servers that expose data and functionality to LLM applications in a secure, standardized way. It separates the concerns of providing context from the actual LLM interaction.

What dependencies are required to run CustomMCPServer?

You need Python, uv (the project manager), and the mcp[cli] package. For the advanced server, black is also added.

How do I install the server in Claude Desktop?

Run uv run mcp install main.py (or uv run mcp install adv_main.py for the advanced version). This adds the server to Claude’s configuration file (claude_desktop_config.json).

How do I troubleshoot if the server does not appear in Claude?

Close the Claude app completely (use Task Manager to end the process), wait a moment, then reopen the app. The MCP server should spin up and appear.

Can I create custom tools with CustomMCPServer?

Yes. The tutorial shows how to add tools (e.g., to connect to a database) and then ask Claude to use them, such as creating 100 fake users automatically.

Comments

More Other MCP servers

ghidraMCP

LaurieWired

MCP Server for Ghidra

9.4K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K