Metadata-Version: 2.4
Name: emko-mcp
Version: 0.1.0
Summary: Emko Elektronik ürün manuellerini (PDF) arayıp okuyan MCP sunucusu
Project-URL: Homepage, https://github.com/OGUZHANCOSKUN/emko-mcp
Project-URL: Issues, https://github.com/OGUZHANCOSKUN/emko-mcp/issues
Author: Oğuzhan Coşkun
License: MIT
Keywords: claude,datasheet,emko,manual,mcp,pdf
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Documentation
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: mcp>=1.2.0
Requires-Dist: pypdf>=4.0
Description-Content-Type: text/markdown

# emko-mcp

Emko Elektronik (www.emkoelektronik.com.tr) ürün manuellerini, broşürlerini ve
firmware dokümanlarını arayıp okuyabilen bir **MCP (Model Context Protocol)**
sunucusu. Claude Desktop, Claude Code veya MCP destekleyen herhangi bir istemciye
bağlanır; PDF'leri arka planda indirip metnini çıkararak modele verir.

## Kurulum

```bash
pip install emko-mcp
```

Kurulduktan sonra `emko-mcp` komutu kullanılabilir hale gelir.

## Claude Desktop'a bağlama

`claude_desktop_config.json` dosyanıza şu girişi ekleyin:

```json
{
  "mcpServers": {
    "emko": {
      "command": "emko-mcp"
    }
  }
}
```

Config dosyasının yeri:
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`

Kaydedip Claude Desktop'ı tamamen kapatıp yeniden açın.

> `emko-mcp` komutu bulunamazsa, tam yolu kullanabilirsiniz. Yolu bulmak için:
> Windows'ta `where emko-mcp`, macOS/Linux'ta `which emko-mcp`.

## Sağladığı araçlar (tools)

- **`emko_search_manuals`** — Bir anahtar kelimeyle (örn. "Proop", "EtherCAT",
  "IPERTU") eşleşen dosyaları listeler. İndirmez, sadece adları döndürür.
- **`emko_get_manual`** — Eşleşen ilk PDF'i indirip metnini çıkarır ve döndürür.
- **`emko_crawl_category`** — Verilen ürün kategori sayfalarına tek tek girip
  manuelleri indeksler (Yükleme Merkezi'nde henüz listelenmemiş yeni ürünler için).

## Örnek kullanım

Claude'a şunları sorabilirsiniz:

- "emko_search_manuals ile Proop panellerinin kılavuzlarını bul"
- "EtherCAT Bus Coupler'ın SDO parametrelerine bak" (Claude uygun tool'u seçer)
- "IPERTU Slim Plus PLC modülünün kullanım kılavuzunu özetle"

## Notlar

- Bu paket, herkese açık `www.emkoelektronik.com.tr` sayfalarını okur;
  kimlik doğrulama gerektirmez.
- Bazı eski broşürler taranmış (görsel) PDF olabilir; bu durumda metin çıkarımı
  sınırlı olur.

## Lisans

MIT
