MCP ツールと MCP サーバーでユーザー管理エージェントを構築するための Python 実装

タスクの概要

シンプルなツールでMCPサーバーを作成して実行します。 作成したサーバーからMCPツールを使用するMCPクライアントでシンプルなユーザー管理エージェントを実装します。

Mackerel 学習目標

このプロジェクトを調べて作業することで、次のことを学びます。

• シンプルなMCPサーバーの設定方法
• クライアントの設定方法とMCPサーバーに接続する方法
• MCPサーバーからツールで簡単なエージェントを作成する方法
• MCPの主な機能

️️ 建築

ツイート

よくある質問

-Python: 3.11以上 -Dependencies: [requirements.txt にリストされている

• ** API Access**:適切な権限を持つDIAL APIキー -Network:内部APIアクセス用のEPAM VPN接続
• ドッカーとドッカーコンポーズ
• ポストマン

タスク !

メインブランチのタスクが難しい場合は、[with-detailed-descriptionブランチに切り替えます

ユーザー管理エージェントを実装する必要があります。これにより、ユーザー管理サービス内でのCRUD操作を実行できます。

MCP サーバーの作成と実行:

1。 ルートドッカーコンポーズを実行します(前のタスクからそれを持っている場合はオプションのステップ) 2. mcp server を開く 3. すべてを実装TODO 4.

Framework-based MCP (Server & Client)

Python implementation for building Users Management Agent with MCP tools and MCP server

🎯 Task Overview

Create and run MCP server with simple tools. Implement simple Users Management Agent with MCP Client that will use MCP tools from created server.

🎓 Learning Goals

By exploring and working with this project, you will learn:

• How to configure simple MCP server
• How to configure client and connect to MCP server
• How to create simple Agent with tools from MCP server
• Key features of MCP

🏗️ Architecture

task/
├── agent/
│   ├── models/           
│   │   └──message.py        ✅ Complete
│   ├── app.py                🚧 TODO: implement logic
│   ├── promps.py             🚧 TODO: write system prompt
│   ├── dial_client.py        🚧 TODO: implement logic
│   └── mcp_cleint.py         🚧 TODO: implement logic
└── mcp_server/               
    ├── server.py             🚧 TODO: implement logic
    ├── user_client.py        ✅ Complete
    └── Dockerfile            ✅ Complete

📋 Requirements

• Python: 3.11 or higher
• Dependencies: Listed in requirements.txt
• API Access: DIAL API key with appropriate permissions
• Network: EPAM VPN connection for internal API access
• Docker and Docker Compose
• Postman

✍️ Tasks:

If the task in the main branch is hard for you, then switch to the with-detailed-description branch

You need to implement the Users Management Agent, that will be able to perform CRUD operations within User Management Service.

Create and run MCP server:

1. Run root docker-compose (Optional step in case if you have it from previous tasks)
2. Open mcp_server
3. Implement all TODO
4. Run mcp_server

OPTIONAL: Work with MCP server in Postman

1. Import mcp.postman_collection to Postman
2. Make init call and get mcp-session-id in response headers
3. Make init-notification. Pay attention that you need to use mcp-session-id retrieved from init request. it should return 202 status
4. Get tools (don’t forget about mcp-session-id). It should return stream with tools.
5. Call calculator (don’t forget about mcp-session-id). It should return stream tool execution result.

Create and run Agent:

1. Open mcp_client and implement all TODO
2. Open dial_client and implement all TODO
3. Open prompts and write System prompt
4. Open app and implement all TODO
5. Run application mcp_client and test that it is connecting to MCP Server and works properly
6. Try with your solution with fetch MCP https://remote.mcpservers.org/fetch/mcp and check the differences on the init step (what they have and don’t)

OPTIONAL: Support both (users-management and fetch) MCP servers: