Skip to main content
Glama
Sign In
theses-mcp

theses-mcp

by koprjaa
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Rust
Remote

theses-mcp

Search Czech university theses and retrieve document links for MCP clients.

CI License: AGPL-3.0

What it does

  • Searches thesis metadata and full texts on theses.cz.

  • Reads titles, abstracts, keywords, and defense information.

  • Finds thesis files, attachments, and reviewer reports on theses.cz or school repositories.

  • Supports your own authenticated sessions through login, use_cookie, and whoami.

Related MCP server: Primo MCP Server

Install

Install a current stable Rust toolchain, then:

cargo install --git https://github.com/koprjaa/theses-mcp

This puts theses-mcp in ~/.cargo/bin. Add this entry to your MCP client's mcpServers configuration:

{
  "theses": {
    "command": "theses-mcp"
  }
}

No environment variables are required for public access.

Use

Ask your MCP client to call these tools:

search(query="midjourney AND autorství", limit=10)
detail(id_or_url="pl09jx")
fulltext(id_or_url="7lfo74")

Use a record's code or URL for detail and fulltext. Search accepts AND, OR, and quoted phrases. Your client exposes the remaining tool parameters.

fulltext returns file links, not extracted text. Check its files and note fields for availability. Some repositories require login or show a CAPTCHA. Call login with the repository host to sign in using your own account. Sessions persist in ~/.theses-mcp/cookies.json; delete that file to forget them. The file format is the one the earlier Python version wrote, so saved sessions keep working.

Browser login

login opens a window of a Chromium-family browser (Chrome, Edge, Brave, Vivaldi, Opera, or Chromium) with a profile of its own in ~/.theses-mcp/browser, and reads back only the cookies of the host you sign in to. It talks to the browser over the Chrome DevTools Protocol, so nothing is downloaded.

  • On Windows it opens your default browser if that is a Chromium build. On macOS and Linux there is no cheap way to ask, so it uses the first Chromium-family browser it finds at the usual places.

  • Firefox and Safari cannot be driven. Use use_cookie with a cookie copied from the browser's developer tools instead.

  • attach=true uses a browser that is already running with --remote-debugging-port.

Check

theses-mcp --selftest runs the parsers against the live sites. It makes several dozen requests, so run it by hand now and then, not in CI.

License

AGPL-3.0-or-later

Available Tools

3 tools
detailA

Fetch the full record of a thesis from theses.cz.

id_or_url: thesis code ("pl09jx"), /id/pl09jx/ or a full URL. Returns author, title (incl. translation), CS/EN abstracts, keywords, supervisor/opponent, full-text availability and the school archive link.

Inputs: id_or_url (required).

fulltextA

Resolve a thesis to downloadable full-text files in its school's repository.

theses.cz stores only metadata; the files live in each school's own system (mostly the IS family — is.muni.cz, is.slu.cz, vskp.vse.cz …). This follows the record to that repository and lists the documents it exposes publicly.

id_or_url: thesis code ("7lfo74"), /id/7lfo74/ or a full URL.

access is the visibility of the theses.cz copy and does NOT decide what you can download: a thesis marked "autentizovaným zaměstnancům ze stejné školy" on theses.cz is often served freely by the school's own repository, so always check files.

Each file carries label, filename and url; extensionless URLs also get confirmed and content_type from a HEAD request. An empty files plus a note means the school really does gate it (login or CAPTCHA) — a real answer, not an error.

Inputs: id_or_url (required).

searchA

Search theses.cz (Czech national thesis registry) — full text and metadata.

Returns two kinds of hits: kind="record" — a thesis record; url points to the detail page (see detail) kind="fulltext" — a match inside the thesis PDF; pdf_url is a direct link to the publicly readable full text

query: search terms; supports theses.cz operators (AND, OR, "phrase") limit: how many results (paginated by 10, max 50)

Inputs: query (required), limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool targets a distinct stage of working with theses.cz: search finds theses or fulltext snippets, detail retrieves full metadata for a single record, and fulltext resolves a thesis to downloadable files in its school repository. Even though search and fulltext both deal with PDFs, their purposes are clearly separate.

    Naming Consistency5/5

    All three tool names are single lowercase words (search, detail, fulltext), following a consistent, minimalist naming convention. While not verb_noun, the style is uniform and predictable, making the set easy to navigate.

    Tool Count5/5

    With only three tools, the server is tightly scoped for its purpose: searching, inspecting, and retrieving full text from a national thesis registry. Each tool earns its place, and the count fits well within the typical 3-15 range for a focused domain.

    Completeness5/5

    The toolset covers the complete user journey for the domain: discover via search, examine metadata via detail, and access actual files via fulltext. There are no obvious gaps—it's a read-only service, and lifecycle operations like create/update are not applicable.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • cds-mcp

      MohamedElashri
      A
      license
      A
      quality
      D
      maintenance
      MCP server for searching and retrieving documents, metadata, and files from CERN Document Server (CDS) with optional CERN SSO authentication.
      6
      MIT

    • Primo MCP Server

      geheharidas
      A
      license
      A
      quality
      D
      maintenance
      MCP server for searching Ex Libris Primo library catalogues and subscribed databases, enabling search, record retrieval, autocomplete, citation generation, and export to BibTeX, RIS, or CSV.
      5
      9
      MIT

    • MEK MCP

      wlagyorgy
      F
      license
      A
      quality
      D
      maintenance
      MCP server to access the Hungarian Electronic Library (MEK) search engines, enabling agentic tools to search and retrieve content.
      4
      -