CustomMCPServer

CustomMCPServer

Python でカスタム MCP サーバーを構築し、AI エージェントに接続します。

• リソース：

  • Python MCP サーバー SDK
  • 参考コード

• MCP サーバーは、基本的に LLM と AI ツールが相互に通信する方法です。Model Context Protocol を使うと、アプリケーションは標準化された方法で LLM にコンテキストを提供できます。これにより、コンテキストの提供と実際の LLM とのやり取りを分離できます。

# create a uv-managed project
$ uv init .
Initialized project `custommcpserver` at `C:\Users\abhis\Desktop\AIAgents\CustomMCPServer`
# Then add MCP to your project dependencies:
$ uv add "mcp[cli]"
# activate python environment as well
$ source .venv/scripts/activate
# You can install this server in Claude Desktop and interact with it right away by running:
# mcp install main.py
# since we're in this vs code we do
$ uv run mcp install main.py
[04/16/25 10:06:31] INFO     Added server 'Demo' to Claude config
                    INFO     Successfully installed Demo in Claude app
# go to claude app > File > settings > Developer > Edit Config - opens up some file and open that claude_desktop_config.json file
# we can see the mcp run main.py(path) is added in that file.
# the mcp server should show up on claude app - if it's not - we do the following
# close claude app - open task manager and search fo claude and right click & do end task.
# wait a sec & open the app again
#  once the app loads , it spins up the mcp server and it shows on app - refer the image below & when you click on tool we can see the
# add tool and server:DEMO

高度な MCP サーバー

• 先に進む前に、MCP とは何か、基本から説明します。
  • LLM アプリケーションにデータや機能を安全かつ標準化された方法で公開するサーバーを構築できます。LLM とのやり取りに特化して設計された Web API のようなものと考えてください。
    • リソースを通じてデータを公開します（GET エンドポイントのようなもので、情報を LLM のコンテキストに読み込むために使われます）。
    • ツールを通じて機能を提供します（POST エンドポイントのようなもので、コードを実行したり、副作用を発生させたりするために使われます）。
    • プロンプトを通じてやり取りのパターンを定義します（LLM とのやり取りに再利用できるテンプレートです）。
    • さらに多くの機能があります。

uv add black
# after creating new mcp server & tool
$ uv run mcp install adv_main.py
[04/16/25 10:44:02] INFO     Added server 'AI Sticky Notes' to Claude config
                    INFO     Successfully installed AI Sticky Notes in Claude app

• 上記の例から、作成したツールを活用して、さまざまなことができるとわかります。
• データベースに接続するツールを追加し、Claude にデータベースへ 100 人分の架空ユーザーを作成するよう依頼すれば、手作業でコピー＆ペーストする必要はありません。さまざまな作業を自動化できます。