Metadata-Version: 2.4
Name: dbschenker-mcp-server
Version: 0.1.1
Summary: MCP Server for DB Schenker Shipments
Keywords: mcp,DB Schenker,model context protocol,Sendify
Author: Ville Vikingsson
Author-email: Ville Vikingsson <villevikingsson@gmail.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python
Requires-Dist: mcp[cli]>=1.26.0
Requires-Dist: playwright>=1.58.0
Requires-Python: >=3.13
Project-URL: Repository, https://github.com/VVikingsson/mcp-server.git
Description-Content-Type: text/markdown

# DB Schenker Shipment Information MCP Server

## My journey and approach

### Understanding MCP:
I had never heard of MCP prior to this, so I started by visiting their documentation. A skill I've developed during my studies is how to use LLMs to improve my learning (as opposed to impede - the trap which many students fall in), so I also asked lots of questions asking for pedagogical explanations. Whenever something didn't quite feel intuitive or right, it was of course important to fact check the robot. Since I've studied network protocols, understanding MCP was rather intuitive.

### Learning Web Scraping:
Automating website interaction is something I've had in mind for some projects that only ever stayed in my head, but with this I had no choice but to learn it. At first, I thought I would be parsing HTML using a simple request library but, of course, someone has always had the same problem as you have and there exists a good library for most things. My approach to selecting a library to use was to describe the use case to an LLM and then ask it for suggestions with provided rationale. I got recommended Playwright, a library for automating web tests, and after looking into it for some time I decided to stick with it. In essence, it launches a headless browser and provides an intuitive way for you as a programmer to navigate it.

### Usability vs Reliability:
Through building this MCP server, I continuously tweaked the timeout values up and down with two opposite arguments in my head:
- The timeout should be short so that a faulty input is swiftly detected
- The timeout should be long so that an end user with poor internet connection does not get timed out for a valid request.

In the end, I decided to go with short timeouts and prioritize usability. Since I have no empirical evidence to base it on, the decision was based on my own experience. I would rather have it work faster the 99/100 times I am using it (with fast network connection) and not at all 1/100 times (with slow network), rather than it working 100/100 times but responding slowly to every input error I make.

## How to test it yourself (with Claude Desktop)
##### 1. [Install uv for your OS](https://docs.astral.sh/uv/getting-started/installation/)
##### 2. Run commands to clone repository and install dependencies
In a new terminal, paste the following:
```
git clone https://github.com/VVikingsson/mcp-server.git
cd mcp-server/dbschenker_server
uv sync

```
##### 3. Set up Claude Desktop 
   - [Download Claude Desktop for your OS](https://claude.com/download) (if you don't already have it)
   - Follow the installation instructions and open the app.
   - Log in or create an account and proceed to the chat view.
   - Now in the app, click the hamburger menu in the top left.
   - Navigate to File -> Settings -> Developer.
   - Click 'Edit Config'.
     <details>
     <summary><it>If you see a file not found error...<it></summary>
     <ul><li>Open your file explorer and head to the parent location of the directory shown in the error (remove "/Claude").</li>
        <li>Create a folder called 'Claude' and continue from the next step.</li></ul>
     </details>
   - [Download the config file](resources/claude_desktop_config.json) and place it in the Claude folder.
##### 4. Verify setup
   - Close Claude Desktop if it was running (you might need to end the in a task manager)
   - Open Claude Desktop
   - Click the + sign to the left of the text field
   - Hover over connectors
   - You should now see "DBSchenker" listed as a connector.

#### You are now ready to test the server! Try asking Claude about the following reference IDs:
- 1806203236 - Valid, one package
- 1806290829 - Valid, two packages
- 180620323  - Invalid, should not find.
- 123        - Invalid format, should tell you to provide a general shipment ID, not a specific type.
