MCP Python 서버—API 래퍼

이 프로젝트는 외부 API를 쿼리하는 도구를 제공하는 Python으로 MCP 서버를 만듭니다. MCP(Model Context Protocol)를 지원하는 Claude Desktop 또는 ChatGPT Desktop과 호환됩니다.

✨ 특징

MCP를 통한 도구 노출
외부 API에 대한 HTTP 쿼리
claude.json을 통해 Claude/Desktop과 직접 통합

🚀 요구 사항

파이썬 3.9 이상
mcp[cli] (pip 또는 uv를 통해 설치 가능)
Claude 또는 ChatGPT 데스크톱(MCP 지원 포함)

📁 프로젝트 구조

지엑스피1

⚙️ 설치

피프와 함께

pip install "mcp[cli]"

UV 포함(추천)

uv init mcp-api-server
cd mcp-api-server
uv add "mcp[cli]"

MCP 설치

mcp install mi_script.py

.env로 설치

mcp install mi_script.py -f .env

종속성 설치

pip install -r requirements.txt

환경 변수

프로젝트 루트에 .env 파일을 만들어 선택적 환경 변수를 정의합니다.

# .env
API_KEY=mi_api_key
API_URL=https://miapi.com/consulta

👷 빠른 시작(Quickstart)

서버 server.py를 생성합니다.

from mcp.server.fastmcp import FastMCP
import httpx

mcp = FastMCP("API Wrapper")

@mcp.tool(description="Consulta una API externa")
async def consultar_api(param: str) -> str:
    """Consulta una API externa con un parámetro y devuelve la respuesta."""
    async with httpx.AsyncClient() as client:
        r = await client.get(f"https://miapi.com/consulta?param={param}")
        return r.text

개발 모드에서 로컬로 실행

mcp dev server.py

프로덕션 모드에서 실행

mcp run server.py

또는 uv를 사용하여:

uv run --with mcp[cli] mcp run server.py

🚀 Claude/Desktop과 통합

Claude/Desktop 구성 폴더에서 claude.json을 찾으세요.

Windows의 경우: %APPDATA%\Claude\claude.json
Linux/macOS: ~/.claude/claude.json

예:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/codigo/backend-curso-inkor/proyectos_memes"
      ]
    },
    "Demo": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "C:\\codigo\\backend-curso-inkor\\MCP\\server.py"
      ]
    }
  }
}

🤖 Claude/Desktop 내에서 사용하세요

모델에게 다음과 같이 질문할 수 있습니다.

"ping" 매개변수와 함께 consult_api 도구를 사용하세요.

그리고 모델은 MCP 서버를 사용하여 실시간 HTTP 호출을 수행합니다.

🎁 보너스: 도구 확장

@mcp.tool()
async def traducir(texto: str, lang: str) -> str:
    return f"Traducido: {texto} → {lang}"

🔍 리소스

공식 MCP 문서: https://docs.mcp.run/
Python SDK 저장소: https://github.com/modelcontextprotocol/mcp

✅ 사랑과 httpx로 만들었습니다 🚀

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Claude Desktop 및 ChatGPT Desktop과 호환되는 외부 API를 쿼리하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜을 구현한 Python 서버입니다.

Related MCP Servers

Optimized Memory MCP Server V2
AgentWong
-
security
A
license
-
quality
A Python-based server that implements the Model Context Protocol to interface with Claude Desktop as an MCP client, supporting interaction through efficient memory management.
Last updated -
1
Python
MIT License
MCP Python Toolbox
gianlucamazza
-
security
F
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
Last updated -
5
Python
MCP Server Python Template
Cris-0k
-
security
A
license
-
quality
A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
Last updated -
15
Python
MIT License
Hubble MCP Server
ascentkorea
A
security
F
license
A
quality
A Python-based Model Context Protocol server that integrates with Claude Desktop, allowing users to connect to Hubble API services by configuring the server with their Hubble API key.
Last updated -
7
Python

View all related MCP servers

Appeared in Searches

Information about anaconda

MCP Python Server — API Wrapper