kawabeshogo/mcp-server-test

3.1

If you are the rightful owner of mcp-server-test and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Model Context Protocol (MCP) server is designed to facilitate the development, testing, and validation of MCP server implementations and client-server communication.

MCP Server Test Repository

This repository is for testing Model Context Protocol (MCP) servers. Based on Python best-practice template featuring:

uv for fast, reproducible dependency management
Ruff (lint + format) for Python
Prettier for non-Python files (JS/TS/JSON/YAML/MD/HTML/CSS)
pytest (tests), pre-commit (quality gates)
VS Code workspace config & tasks
Dev Container (Codespaces-ready)
GitHub Actions CI (pre-commit: Ruff + Prettier, then tests, then build)
Opinionated project structure (src/ layout, type hints, 100-line limit)

Purpose

This repository is specifically designed for:

Testing MCP (Model Context Protocol) server implementations
Experimenting with MCP client-server communication
Developing and validating MCP tools and capabilities

Quickstart

# 1) Clone this repository
# 2) Initialize the project:
scripts/bootstrap.sh mcp_server_test
# or on Windows PowerShell:
# scripts/New-Project.ps1 -ProjectName mcp_server_test

# 3) Run dev tasks
uv run pytest -q
uv run ruff check --fix && uv run ruff format
# Optional (if Node installed): npx prettier --write .

MCP Server Development

Directory Structure

src/mcp_server_test/ - Main MCP server implementation
tests/ - Test cases for MCP server functionality
scripts/ - Development and deployment scripts

Development Workflow

Implement MCP server tools in src/mcp_server_test/
Add corresponding tests in tests/
Run tests with uv run pytest
Format code with uv run ruff format

Formatting policy

Python: Ruff (formatter + lint)
Others: Prettier (VS Code format-on-save + pre-commit)