OpenTK Model Context Protocol Server

# Testing the OpenTK MCP Server This document provides information about testing the OpenTK MCP server and checking which endpoints are working as expected. ## Endpoint Status Check To check the status of all endpoints, run: ```bash npm run check-endpoints ``` This will test all the endpoints and provide a report showing which ones are working and which ones are failing. ## Endpoints Being Tested The following endpoints are tested: 1. **Search API** - `POST https://berthub.eu/tkconv/search` - Tests searching for documents using the tkconv API - Uses proper headers and form data 2. **Document HTML** - `GET https://berthub.eu/tkconv/document.html?nummer=2024D39058` - Tests fetching a document's HTML page - Checks if the page contains a document link 3. **Document Download** - `GET https://berthub.eu/tkconv/getraw/2024D39058` - Tests downloading a document's binary content - Verifies that the content is a PDF 4. **Sitemap** - `GET https://berthub.eu/tkconv/sitemap-2024.txt` - Tests fetching a sitemap of URLs - Checks if the sitemap contains URLs 5. **External Reference** - `GET https://berthub.eu/tkconv/op/2024D39058` - Tests resolving an external reference to a URL - Checks if the response contains a redirect 6. **OData Persons** - `GET https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Personen` - Tests fetching persons from the OData API - Verifies that the response contains person data 7. **OData Single Person** - `GET https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Personen(1)` - Tests fetching a single person from the OData API - Checks if the response contains the person's data ## Manual Testing You can also manually test the endpoints using tools like curl or Postman. Here are some example commands: ### Search API ```bash curl -X POST \ -H "Accept: */*" \ -H "User-Agent: Mozilla/5.0" \ -H "Referer: https://berthub.eu/tkconv/search.html" \ -H "Origin: https://berthub.eu" \ -H "Host: berthub.eu" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "q=kunstmatige%20intelligentie&twomonths=false&soorten=" \ https://berthub.eu/tkconv/search ``` ### Document HTML ```bash curl -X GET https://berthub.eu/tkconv/document.html?nummer=2024D39058 ``` ### Document Download ```bash curl -X GET https://berthub.eu/tkconv/getraw/2024D39058 --output document.pdf ``` ### Sitemap ```bash curl -X GET https://berthub.eu/tkconv/sitemap-2024.txt ``` ### External Reference ```bash curl -X GET -I https://berthub.eu/tkconv/op/2024D39058 ``` ### OData Persons ```bash curl -X GET https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Personen?$top=5 ``` ### OData Single Person ```bash curl -X GET https://gegevensmagazijn.tweedekamer.nl/OData/v4/2.0/Personen(1) ``` ## Troubleshooting If an endpoint is not working as expected, check the following: 1. **Network Connectivity**: Make sure you have internet access and can reach the API servers. 2. **API Changes**: The external APIs may have changed their structure or requirements. 3. **Rate Limiting**: You might be hitting rate limits if you make too many requests. 4. **Authentication**: Some endpoints might require authentication or specific headers. 5. **Content Type**: Make sure you're sending the correct Content-Type header for POST requests. ## Adding New Tests To add tests for new endpoints, edit the `scripts/check-endpoints.js` file and add a new entry to the `endpoints` array.