TR Dizin

You can run the TR Dizin MCP Server to search the TR Dizin database for publications, journals, and authors through MCP clients. It supports cloud deployment via Smithery for easy setup and also provides a manual, self-hosted path using Python, along with guidance for desktop client integration.

How to use

Connect with an MCP client to access three core functions: search TR Dizin publications, search TR Dizin journals, and search TR Dizin authors. Use the search endpoints to query, sort results by publication year, title, or relevance, paginate through results, and set a per-page limit. If you choose the Smithery deployment, provide your Firecrawl API key in the client configuration to enable authenticated access. When using a local setup, supply the FIRECRAWL_API_KEY in the environment to authorize requests.

How to install

Prerequisites: Python 3.11+ and a Firecrawl API key.

# 1. Repoyu klonlayın
git clone <repo-url>
cd trdizin-mcp

# 2. Sanal ortam oluşturun
python3 -m venv venv
source venv/bin/activate  # Linux/macOS
# veya
venv\Scripts\activate     # Windows

# 3. Bağımlılıkları yükleyin
pip install -r requirements.txt

# 4. Environment variable ayarlayın
export FIRECRAWL_API_KEY="your-api-key-here"

# 5. Server'ı çalıştırın
python server.py

Claude Desktop ile Manuel Kullanım için konfigürasyonu kullanmaya başlayabilirsiniz.

Additional setup for Claude Desktop and Smithery

If you want to run the server through Claude Desktop, add the following to the Claude Desktop configuration so it can launch the MCP server as a local process.

{
  "mcpServers": {
    "trdizin": {
      "command": "python3",
      "args": ["/path/to/trdizin-mcp/server.py"],
      "env": {
        "FIRECRAWL_API_KEY": "your-api-key-here",
        "PYTHONPATH": "/path/to/trdizin-mcp"
      }
    }
  }
}

Smithery deployment and API key setup

You can deploy the TR Dizin MCP Server through Smithery for quick setup. Use Smithery to locate and install the TR Dizin MCP Server, then add your Firecrawl API key to the configuration.

Steps (summary): login to Smithery, find and install the TR Dizin MCP Server, configure with your Firecrawl API key, and start using it with Claude Desktop or other MCP clients.

Direct Smithery link for the server: https://smithery.ai/server/%40Utku-Unluer%2Fsmithery-trdizin-search-mcp/tools

Docker with Firecrawl API key

You can run a Docker container with your Firecrawl API key to start the MCP server in an isolated environment.

# Docker image build
docker build -t trdizin-mcp .

# Container run with API key
docker run -e FIRECRAWL_API_KEY="your-api-key" -it trdizin-mcp

Geliştirme and debugging notes

For local development and debugging, you can enable verbose logging by setting DEBUG=1 when running the server.

export DEBUG=1
python server.py

Troubleshooting tips

Common issues include missing Firecrawl API key, missing dependencies, or network timeouts. Ensure the API key is valid and correctly configured, install all dependencies with the provided requirements file, and verify internet connectivity and access to TR Dizin endpoints.

Notes on usage with MCP clients

The MCP server exposes endpoints for three search capabilities: publications, journals, and authors. You can tailor the query terms, sort orders, and pagination to fit your use case. When using the Smithery deployment, you interact with the remote MCP service as your data source.

Available tools

search_trdizin_publications

Search TR Dizin publications with options for query, order, page, and limit.

search_trdizin_journals

Search TR Dizin journals with options for query, order, page, and limit.

search_trdizin_authors

Search TR Dizin authors with options for query, order, page, and limit.