Simple MCP Server

Simple MCP Server

A Python Flask-based Model Context Protocol server that provides basic tools including hello_world, calculate, and get_time functions through stable HTTP endpoints.

Category
Visit Server

README

Simple MCP Server (Python Flask)

간단한 테스트용 MCP (Model Context Protocol) 서버입니다. Python Flask로 구현되어 안정적인 HTTP 엔드포인트를 제공합니다.

기능

이 서버는 다음과 같은 기본 도구들을 제공합니다:

  • hello_world: 간단한 인사 메시지 반환
  • calculate: 기본 산술 연산 (덧셈, 뺄셈, 곱셈, 나눗셈)
  • get_time: 현재 시간 반환

설치

pip install -r requirements.txt

실행

로컬 개발

python app.py

프로덕션 (Gunicorn)

gunicorn --bind 0.0.0.0:3000 --workers 1 app:app

테스트

python test.py

배포

smithery.ai에 배포하려면:

./deploy.sh

개발

Python Flask 기반으로 작성되었으며, 다음과 같은 구조를 가집니다:

  • app.py - Flask 기반 MCP 서버 (메인 애플리케이션)
  • requirements.txt - Python 의존성 설정
  • Dockerfile - Docker 컨테이너 설정 (Python 기반)
  • smithery.yaml - smithery.ai 배포 설정 (Custom Deploy)
  • test.py - Python 테스트 스크립트
  • deploy.sh - 배포 스크립트

배포 방식

  • 로컬 개발: python app.py (Flask 개발 서버)
  • smithery.ai 배포: Custom Deploy (Docker 컨테이너)
    • Flask 앱이 HTTP 엔드포인트 제공
    • /mcp 엔드포인트에서 lazy loading 지원
    • Gunicorn으로 프로덕션 서버 실행
    • CORS 지원으로 브라우저 호환성 확보

API 엔드포인트

  • GET /: 헬스체크
  • GET /health: 헬스체크 (별칭)
  • GET /mcp: 도구 목록 반환 (lazy loading)
  • POST /mcp: MCP 프로토콜 요청 처리
  • DELETE /mcp: 서버 종료 요청

사용 예시

hello_world 도구

{
  "name": "hello_world",
  "arguments": {
    "name": "Alice"
  }
}

calculate 도구

{
  "name": "calculate",
  "arguments": {
    "operation": "add",
    "a": 10,
    "b": 5
  }
}

get_time 도구

{
  "name": "get_time",
  "arguments": {}
}

요구사항

  • Node.js 18 이상
  • npm 또는 yarn

라이센스

MIT

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured