MCP.so

๐Ÿš€ Build Custom MCP Servers ๐Ÿ“โ˜€๏ธ๐Ÿ“ฐ

@sourangshupal

๐Ÿš€ Build Custom MCP Servers ๐Ÿ“โ˜€๏ธ๐Ÿ“ฐ ใซใคใ„ใฆ

ๆฆ‚่ฆใฏใพใ ใ‚ใ‚Šใพใ›ใ‚“

ๅŸบๆœฌๆƒ…ๅ ฑ

ใ‚ซใƒ†ใ‚ดใƒช

้–‹็™บ่€…ใƒ„ใƒผใƒซ

ใƒฉใƒณใ‚ฟใ‚คใƒ 

python

ใƒˆใƒฉใƒณใ‚นใƒใƒผใƒˆ

stdio

ๅ…ฌ้–‹่€…

sourangshupal

่จญๅฎš

ไปฅไธ‹ใฎ่จญๅฎšใ‚’ไฝฟใฃใฆใ€ใ“ใฎใ‚ตใƒผใƒใƒผใ‚’ MCP ๅฏพๅฟœใ‚ฏใƒฉใ‚คใ‚ขใƒณใƒˆใซ่ฟฝๅŠ ใ—ใฆใใ ใ•ใ„ใ€‚

{
  "mcpServers": {
    "Build-Custom-MCP-Servers": {
      "command": "uv",
      "args": [
        "sync"
      ]
    }
  }
}

ใƒ„ใƒผใƒซ

ใƒ„ใƒผใƒซใฏๆคœๅ‡บใ•ใ‚Œใพใ›ใ‚“ใงใ—ใŸ

ใƒ„ใƒผใƒซใฏ README ใ‹ใ‚‰่‡ชๅ‹•็š„ใซๆŠฝๅ‡บใ•ใ‚Œใพใ™ใ€‚ใƒกใƒณใƒ†ใƒŠใƒผใฏ ## Tools ใจใ„ใ†่ฆ‹ๅ‡บใ—ใฎไธ‹ใซ่จ˜่ผ‰ใ™ใ‚‹ใ“ใจใงใ€ใ“ใฎใ‚ฟใƒ–ใซๅๆ˜ ใงใใพใ™ใ€‚

ๆฆ‚่ฆ

What is Build Custom MCP Servers?

This project demonstrates building simple MCP servers using the MCP Python SDK (mcp[cli]). It provides tools for note management, weather fetching, and news searching, using external API keys stored in a .env file.

How to use Build Custom MCP Servers?

Install Python 3.12 and a virtual environment manager. Clone the repository, set up a virtual environment, and install dependencies (e.g., uv sync). Copy .env.example to .env and add your WEATHER_API_KEY and BRAVE_API_KEY. Run the server with mcp install main.py to add it to Claude Desktop, or use mcp dev main.py for development.

Key features of Build Custom MCP Servers

  • Note-taking: add, read, latest, and summarize notes.
  • Current weather data for any city via WeatherAPI.com.
  • News search using the Brave Search API.
  • Configuration via .env file with API keys.
  • Built with mcp[cli] Python SDK.

Use cases of Build Custom MCP Servers

  • Manage personal notes through an MCP client like Claude Desktop.
  • Check realโ€‘time weather during conversations.
  • Search for news articles without leaving the chat interface.
  • Learn how to build and run custom MCP servers.

FAQ from Build Custom MCP Servers

What tools does the MCP server provide?

It offers note management (add, read, latest, summarize), current weather fetching, and Brave Search news retrieval.

What API keys are required?

You need a WeatherAPI.com key (WEATHER_API_KEY) and a Brave Search API key (BRAVE_API_KEY).

What Python version is needed?

Python 3.12 is required.

How do I run the server?

Use mcp install main.py to register the server with Claude Desktop, or mcp dev main.py

ใ‚ณใƒกใƒณใƒˆ

ใ€Œ้–‹็™บ่€…ใƒ„ใƒผใƒซใ€ใฎไป–ใฎใ‚ณใƒณใƒ†ใƒณใƒ„