rslapp 1.0.0__tar.gz

rslapp-1.0.0/.gitignore

@@ -0,0 +1,52 @@
+# Sistema e editor
+.DS_Store
+Thumbs.db
+*.swp
+.idea/
+.vscode/
+
+# Segredos: nunca vão para o git
+.env
+.env.*
+!.env.example
+.pypirc
+*.pem
+*.key
+*.p12
+*.pfx
+secrets.*
+credentials.*
+
+# Configuração local de clientes MCP: o bloco "env" costuma trazer chaves de API
+.mcp.json
+claude_desktop_config.json
+
+# Configuração local dos agentes: chaves de ferramentas locais ficam aqui, nunca no git
+.claude/settings.local.json
+
+# Árvores de trabalho do Playmaker, para agentes em paralelo
+.worktrees/
+
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+venv/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+.ruff_cache/
+.coverage
+
+# Dados e exportações de teste feitos na pasta do projeto (os dados reais ficam na pasta do usuário)
+# Trazem nome, ORCID e afiliação de autores (D-004): nunca vão para o git.
+/data/
+/exports/
+/searches/
+/lists/
+/cache/
+/log.md
+/*.ris
+/*.csv
+*.log

rslapp-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Erick Cardoso Mendes
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

rslapp-1.0.0/PKG-INFO

@@ -0,0 +1,179 @@
+Metadata-Version: 2.5
+Name: rslapp
+Version: 1.0.0
+Summary: Servidor MCP em Python para busca acadêmica e exportação para revisão sistemática
+Project-URL: Homepage, https://github.com/Erick-wilding675/RSL-MCP-APP
+Project-URL: Issues, https://github.com/Erick-wilding675/RSL-MCP-APP/issues
+Author: Erick Cardoso Mendes
+License-Expression: MIT
+License-File: LICENSE
+Keywords: bibliometrics,crossref,mcp,openalex,semantic-scholar,systematic-review,vosviewer
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Science/Research
+Classifier: Natural Language :: Portuguese (Brazilian)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Requires-Python: >=3.10
+Requires-Dist: httpx
+Requires-Dist: mcp<3,>=2
+Requires-Dist: typing-extensions
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# RSL.app
+
+**Servidor MCP gratuito para revisão sistemática de literatura.** Você pede à sua IA, em linguagem natural, os artigos de um tema. Ela busca no OpenAlex, na Crossref e na Semantic Scholar, junta os resultados sem duplicatas e grava um arquivo pronto para abrir no [VOSviewer](https://www.vosviewer.com/), com autores, afiliações, palavras-chave, referências e citações.
+
+> Exemplo: *"Quero os artigos sobre burnout em professores da educação básica e, separado, sobre inteligência artificial na correção de redações. Exporte cada um em RIS."*
+> A IA faz duas buscas, monta duas listas e entrega dois arquivos `.ris`. Cada busca fica registrada num log legível, que você pode anexar à metodologia do seu artigo.
+
+O RSL.app roda **na sua máquina** (self-hosted), com as **suas** chaves gratuitas. Ele não tem servidor central, não cobra nada e não manda seus dados para lugar nenhum além das próprias bases consultadas.
+
+## O que ele faz
+
+- **Busca por tema, palavra-chave, subtema ou título** nas três bases abertas, ao mesmo tempo.
+- **Tira as duplicatas.** O mesmo artigo vindo de mais de uma base aparece uma vez só, com os ids de cada base.
+- **Avisa quando a lista está incompleta.** Se uma base falha ou um limite corta a busca, a lista sai marcada como incompleta, com o motivo. Nenhuma lista incompleta passa por completa.
+- **Acha um artigo específico** pelo título ou pelo DOI.
+- **Traz as referências de um artigo e quem o cita**, como uma lista própria.
+- **Registra cada busca num log** (`log.md`): o pedido, a string enviada a cada base, a data, quantos artigos cada base achou e se veio do cache.
+- **Repete uma busca do log** com as mesmas strings, para atualizar uma revisão.
+- **Exporta em cinco formatos:** RIS, CSV no padrão do Scopus, JSON completo, lista de DOIs e URL de consulta do OpenAlex. O RIS, o CSV e a lista de DOIs abrem no VOSviewer sem edição.
+- **Guarda tudo na sua máquina:** listas, log, exportações e um cache das respostas, que expira em 7 dias e economiza sua cota.
+
+Ele **não** baixa texto completo de artigos, não abre o VOSviewer sozinho e não junta buscas diferentes numa lista só: cada pedido vira a sua própria lista.
+
+## Do que você precisa
+
+1. **Uma IA que fale MCP**, como o Claude Desktop, o Claude Code ou outro cliente compatível.
+2. **O [uv](https://docs.astral.sh/uv/getting-started/installation/)** instalado. É ele que baixa e roda o RSL.app; você não precisa instalar o Python à mão.
+3. **Uma chave gratuita do OpenAlex**, obrigatória. Crie em [openalex.org/settings/api](https://openalex.org/settings/api) e **ative pelo link que chega no e-mail**: a chave só funciona depois disso. Ela dá 10.000 créditos por dia, e uma busca gasta cerca de 10.
+4. **Opcional: uma chave gratuita da [Semantic Scholar](https://www.semanticscholar.org/product/api#api-key-form).** Sem ela a Semantic Scholar funciona, mas recusa pedidos com mais frequência.
+
+A Crossref não precisa de chave.
+
+## Instalação no Claude Desktop
+
+1. Feche o Claude Desktop por completo (no Windows, clique com o botão direito no ícone perto do relógio e escolha **Quit**).
+2. Abra a configuração: **Settings → Developer → Edit Config**. O arquivo é o `claude_desktop_config.json`.
+3. Acrescente o `rslapp` dentro de `"mcpServers"`:
+
+```json
+{
+  "mcpServers": {
+    "rslapp": {
+      "command": "uvx",
+      "args": ["rslapp"],
+      "env": {
+        "OPENALEX_API_KEY": "sua-chave-do-openalex",
+        "SEMANTIC_SCHOLAR_API_KEY": "sua-chave-da-semantic-scholar"
+      }
+    }
+  }
+}
+```
+
+4. Salve e abra o Claude Desktop de novo. O `rslapp` aparece na lista de ferramentas, com oito ferramentas.
+5. Para conferir, peça: *"Quais fontes do rslapp estão prontas?"*. A IA chama `list_sources` e deve mostrar as três fontes como `ok`.
+
+**Se o Claude Desktop não achar o `uvx`:** troque `"uvx"` pelo caminho completo. No Windows, costuma ser `C:\\Users\\<seu-usuário>\\.local\\bin\\uvx.exe`. No macOS e no Linux, rode `which uvx` no terminal para descobrir.
+
+**Suas chaves ficam só no arquivo de configuração da sua máquina.** O RSL.app nunca as escreve no log, nas listas nem nas respostas à IA.
+
+### No Claude Code
+
+```bash
+claude mcp add rslapp -e OPENALEX_API_KEY=sua-chave -e SEMANTIC_SCHOLAR_API_KEY=sua-chave -- uvx rslapp
+```
+
+### Em outros clientes MCP
+
+O RSL.app é um servidor MCP por **stdio**. O comando é `uvx rslapp`, e as chaves vão como variáveis de ambiente.
+
+## Como usar
+
+Fale com a IA normalmente. Alguns pedidos que funcionam bem:
+
+- *"Busque artigos sobre aprendizagem baseada em projetos no ensino de ciências e exporte em RIS."*
+- *"Ache o artigo 'Software survey: VOSviewer, a computer program for bibliometric mapping' e me traga até 200 trabalhos que o citam, de cada base."*
+- *"Me mostre o log das buscas de hoje."*
+- *"Repita a busca s-0003 e exporte em CSV."*
+
+A IA planeja antes de buscar: se o pedido tem assuntos diferentes, ela faz uma busca e uma lista para cada um.
+
+### Abrir no VOSviewer
+
+| Arquivo | Como abrir no VOSviewer |
+|---|---|
+| `.ris` | Create → *Create a map based on bibliographic data* → *Read data from reference manager files* → RIS |
+| `.csv` | Create → *Create a map based on bibliographic data* → *Read data from bibliographic database files* → aba **Scopus** |
+| `.dois.txt` | Create → *Create a map based on bibliographic data* → *Read data through API* |
+| `.openalex.txt` | A URL da consulta ao OpenAlex (uma por linha, até 100 artigos cada), com os artigos da lista que vieram do OpenAlex |
+
+O CSV leva as referências como DOIs, o que permite mapas de citação e de acoplamento bibliográfico.
+
+## Onde ficam os arquivos
+
+Por padrão, na pasta `RSL.app` dentro da sua pasta de usuário (no Windows, `C:\Users\<seu-usuário>\RSL.app`):
+
+| Pasta ou arquivo | O que tem |
+|---|---|
+| `log.md` | O log legível de todas as buscas |
+| `exports/` | Os arquivos exportados (`l-0001.ris`, `l-0001.csv`…) |
+| `lists/` e `searches/` | As listas e as buscas salvas, para reexportar depois |
+| `cache/` | As respostas das bases, por 7 dias |
+
+## Configuração
+
+Tudo por variáveis de ambiente, no bloco `env` da configuração do cliente. Nenhuma exige mexer no código.
+
+| Variável | O que faz | Padrão |
+|---|---|---|
+| `OPENALEX_API_KEY` | Chave do OpenAlex (obrigatória para o OpenAlex) | - |
+| `SEMANTIC_SCHOLAR_API_KEY` | Chave da Semantic Scholar (opcional) | - |
+| `RSL_CONTACT_EMAIL` | Seu e-mail, enviado à Crossref, que atende mais rápido quem se identifica (opcional) | - |
+| `RSL_DATA_DIR` | Onde guardar listas, log e cache | `~/RSL.app` |
+| `RSL_EXPORT_DIR` | Onde gravar as exportações | `<RSL_DATA_DIR>/exports` |
+| `RSL_CACHE_DAYS` | Por quantos dias o cache vale | `7` |
+
+## As ferramentas que a IA recebe
+
+| Ferramenta | O que faz |
+|---|---|
+| `search_works` | Busca por termos nas três bases e cria uma lista |
+| `find_work` | Acha um artigo específico por título ou DOI |
+| `get_related_works` | Traz as referências ou as citações de um artigo, até um teto por base (padrão 1.000) |
+| `repeat_search` | Repete uma busca do log |
+| `get_list` | Mostra uma lista salva, por páginas |
+| `get_search_log` | Mostra o log e o caminho do `log.md` |
+| `export_list` | Grava a lista em `ris`, `csv`, `json`, `dois` ou `openalex_url` |
+| `list_sources` | Diz quais bases estão prontas |
+| `plan_search` (prompt) | Orienta a IA a planejar e dividir o pedido antes de buscar |
+
+O contrato completo, com entradas, respostas e códigos de erro, está em [`docs/interface-contract.md`](docs/interface-contract.md).
+
+## Dados pessoais
+
+As listas guardam nome, ORCID e afiliação dos autores, que são dados públicos das próprias bases e formam os nós das redes de coautoria. Eles ficam só na sua máquina, na pasta de dados, e não vão para nenhum outro lugar. Para apagar tudo, apague a pasta.
+
+## Para quem desenvolve
+
+```bash
+git clone https://github.com/Erick-wilding675/RSL-MCP-APP.git
+cd RSL-MCP-APP
+uv run --isolated --no-editable --reinstall-package rslapp --python 3.10 --extra dev ruff check .
+uv run --isolated --no-editable --reinstall-package rslapp --python 3.10 --extra dev pytest -q
+```
+
+A pasta [`docs/`](docs/) tem a descrição do sistema, os requisitos, a arquitetura, as decisões e uma spec por tarefa. Python 3.10 ou mais novo, SDK oficial do MCP (`mcp>=2,<3`).
+
+## Licença
+
+[MIT](LICENSE). Uso livre, sem fins comerciais por parte do projeto. Respeite os termos de uso de cada base consultada.

rslapp-1.0.0/README.md

@@ -0,0 +1,150 @@
+# RSL.app
+
+**Servidor MCP gratuito para revisão sistemática de literatura.** Você pede à sua IA, em linguagem natural, os artigos de um tema. Ela busca no OpenAlex, na Crossref e na Semantic Scholar, junta os resultados sem duplicatas e grava um arquivo pronto para abrir no [VOSviewer](https://www.vosviewer.com/), com autores, afiliações, palavras-chave, referências e citações.
+
+> Exemplo: *"Quero os artigos sobre burnout em professores da educação básica e, separado, sobre inteligência artificial na correção de redações. Exporte cada um em RIS."*
+> A IA faz duas buscas, monta duas listas e entrega dois arquivos `.ris`. Cada busca fica registrada num log legível, que você pode anexar à metodologia do seu artigo.
+
+O RSL.app roda **na sua máquina** (self-hosted), com as **suas** chaves gratuitas. Ele não tem servidor central, não cobra nada e não manda seus dados para lugar nenhum além das próprias bases consultadas.
+
+## O que ele faz
+
+- **Busca por tema, palavra-chave, subtema ou título** nas três bases abertas, ao mesmo tempo.
+- **Tira as duplicatas.** O mesmo artigo vindo de mais de uma base aparece uma vez só, com os ids de cada base.
+- **Avisa quando a lista está incompleta.** Se uma base falha ou um limite corta a busca, a lista sai marcada como incompleta, com o motivo. Nenhuma lista incompleta passa por completa.
+- **Acha um artigo específico** pelo título ou pelo DOI.
+- **Traz as referências de um artigo e quem o cita**, como uma lista própria.
+- **Registra cada busca num log** (`log.md`): o pedido, a string enviada a cada base, a data, quantos artigos cada base achou e se veio do cache.
+- **Repete uma busca do log** com as mesmas strings, para atualizar uma revisão.
+- **Exporta em cinco formatos:** RIS, CSV no padrão do Scopus, JSON completo, lista de DOIs e URL de consulta do OpenAlex. O RIS, o CSV e a lista de DOIs abrem no VOSviewer sem edição.
+- **Guarda tudo na sua máquina:** listas, log, exportações e um cache das respostas, que expira em 7 dias e economiza sua cota.
+
+Ele **não** baixa texto completo de artigos, não abre o VOSviewer sozinho e não junta buscas diferentes numa lista só: cada pedido vira a sua própria lista.
+
+## Do que você precisa
+
+1. **Uma IA que fale MCP**, como o Claude Desktop, o Claude Code ou outro cliente compatível.
+2. **O [uv](https://docs.astral.sh/uv/getting-started/installation/)** instalado. É ele que baixa e roda o RSL.app; você não precisa instalar o Python à mão.
+3. **Uma chave gratuita do OpenAlex**, obrigatória. Crie em [openalex.org/settings/api](https://openalex.org/settings/api) e **ative pelo link que chega no e-mail**: a chave só funciona depois disso. Ela dá 10.000 créditos por dia, e uma busca gasta cerca de 10.
+4. **Opcional: uma chave gratuita da [Semantic Scholar](https://www.semanticscholar.org/product/api#api-key-form).** Sem ela a Semantic Scholar funciona, mas recusa pedidos com mais frequência.
+
+A Crossref não precisa de chave.
+
+## Instalação no Claude Desktop
+
+1. Feche o Claude Desktop por completo (no Windows, clique com o botão direito no ícone perto do relógio e escolha **Quit**).
+2. Abra a configuração: **Settings → Developer → Edit Config**. O arquivo é o `claude_desktop_config.json`.
+3. Acrescente o `rslapp` dentro de `"mcpServers"`:
+
+```json
+{
+  "mcpServers": {
+    "rslapp": {
+      "command": "uvx",
+      "args": ["rslapp"],
+      "env": {
+        "OPENALEX_API_KEY": "sua-chave-do-openalex",
+        "SEMANTIC_SCHOLAR_API_KEY": "sua-chave-da-semantic-scholar"
+      }
+    }
+  }
+}
+```
+
+4. Salve e abra o Claude Desktop de novo. O `rslapp` aparece na lista de ferramentas, com oito ferramentas.
+5. Para conferir, peça: *"Quais fontes do rslapp estão prontas?"*. A IA chama `list_sources` e deve mostrar as três fontes como `ok`.
+
+**Se o Claude Desktop não achar o `uvx`:** troque `"uvx"` pelo caminho completo. No Windows, costuma ser `C:\\Users\\<seu-usuário>\\.local\\bin\\uvx.exe`. No macOS e no Linux, rode `which uvx` no terminal para descobrir.
+
+**Suas chaves ficam só no arquivo de configuração da sua máquina.** O RSL.app nunca as escreve no log, nas listas nem nas respostas à IA.
+
+### No Claude Code
+
+```bash
+claude mcp add rslapp -e OPENALEX_API_KEY=sua-chave -e SEMANTIC_SCHOLAR_API_KEY=sua-chave -- uvx rslapp
+```
+
+### Em outros clientes MCP
+
+O RSL.app é um servidor MCP por **stdio**. O comando é `uvx rslapp`, e as chaves vão como variáveis de ambiente.
+
+## Como usar
+
+Fale com a IA normalmente. Alguns pedidos que funcionam bem:
+
+- *"Busque artigos sobre aprendizagem baseada em projetos no ensino de ciências e exporte em RIS."*
+- *"Ache o artigo 'Software survey: VOSviewer, a computer program for bibliometric mapping' e me traga até 200 trabalhos que o citam, de cada base."*
+- *"Me mostre o log das buscas de hoje."*
+- *"Repita a busca s-0003 e exporte em CSV."*
+
+A IA planeja antes de buscar: se o pedido tem assuntos diferentes, ela faz uma busca e uma lista para cada um.
+
+### Abrir no VOSviewer
+
+| Arquivo | Como abrir no VOSviewer |
+|---|---|
+| `.ris` | Create → *Create a map based on bibliographic data* → *Read data from reference manager files* → RIS |
+| `.csv` | Create → *Create a map based on bibliographic data* → *Read data from bibliographic database files* → aba **Scopus** |
+| `.dois.txt` | Create → *Create a map based on bibliographic data* → *Read data through API* |
+| `.openalex.txt` | A URL da consulta ao OpenAlex (uma por linha, até 100 artigos cada), com os artigos da lista que vieram do OpenAlex |
+
+O CSV leva as referências como DOIs, o que permite mapas de citação e de acoplamento bibliográfico.
+
+## Onde ficam os arquivos
+
+Por padrão, na pasta `RSL.app` dentro da sua pasta de usuário (no Windows, `C:\Users\<seu-usuário>\RSL.app`):
+
+| Pasta ou arquivo | O que tem |
+|---|---|
+| `log.md` | O log legível de todas as buscas |
+| `exports/` | Os arquivos exportados (`l-0001.ris`, `l-0001.csv`…) |
+| `lists/` e `searches/` | As listas e as buscas salvas, para reexportar depois |
+| `cache/` | As respostas das bases, por 7 dias |
+
+## Configuração
+
+Tudo por variáveis de ambiente, no bloco `env` da configuração do cliente. Nenhuma exige mexer no código.
+
+| Variável | O que faz | Padrão |
+|---|---|---|
+| `OPENALEX_API_KEY` | Chave do OpenAlex (obrigatória para o OpenAlex) | - |
+| `SEMANTIC_SCHOLAR_API_KEY` | Chave da Semantic Scholar (opcional) | - |
+| `RSL_CONTACT_EMAIL` | Seu e-mail, enviado à Crossref, que atende mais rápido quem se identifica (opcional) | - |
+| `RSL_DATA_DIR` | Onde guardar listas, log e cache | `~/RSL.app` |
+| `RSL_EXPORT_DIR` | Onde gravar as exportações | `<RSL_DATA_DIR>/exports` |
+| `RSL_CACHE_DAYS` | Por quantos dias o cache vale | `7` |
+
+## As ferramentas que a IA recebe
+
+| Ferramenta | O que faz |
+|---|---|
+| `search_works` | Busca por termos nas três bases e cria uma lista |
+| `find_work` | Acha um artigo específico por título ou DOI |
+| `get_related_works` | Traz as referências ou as citações de um artigo, até um teto por base (padrão 1.000) |
+| `repeat_search` | Repete uma busca do log |
+| `get_list` | Mostra uma lista salva, por páginas |
+| `get_search_log` | Mostra o log e o caminho do `log.md` |
+| `export_list` | Grava a lista em `ris`, `csv`, `json`, `dois` ou `openalex_url` |
+| `list_sources` | Diz quais bases estão prontas |
+| `plan_search` (prompt) | Orienta a IA a planejar e dividir o pedido antes de buscar |
+
+O contrato completo, com entradas, respostas e códigos de erro, está em [`docs/interface-contract.md`](docs/interface-contract.md).
+
+## Dados pessoais
+
+As listas guardam nome, ORCID e afiliação dos autores, que são dados públicos das próprias bases e formam os nós das redes de coautoria. Eles ficam só na sua máquina, na pasta de dados, e não vão para nenhum outro lugar. Para apagar tudo, apague a pasta.
+
+## Para quem desenvolve
+
+```bash
+git clone https://github.com/Erick-wilding675/RSL-MCP-APP.git
+cd RSL-MCP-APP
+uv run --isolated --no-editable --reinstall-package rslapp --python 3.10 --extra dev ruff check .
+uv run --isolated --no-editable --reinstall-package rslapp --python 3.10 --extra dev pytest -q
+```
+
+A pasta [`docs/`](docs/) tem a descrição do sistema, os requisitos, a arquitetura, as decisões e uma spec por tarefa. Python 3.10 ou mais novo, SDK oficial do MCP (`mcp>=2,<3`).
+
+## Licença
+
+[MIT](LICENSE). Uso livre, sem fins comerciais por parte do projeto. Respeite os termos de uso de cada base consultada.

rslapp-1.0.0/pyproject.toml

@@ -0,0 +1,62 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+# D-008: Pacote publicado no PyPI para execução isolada via uvx
+name = "rslapp"
+version = "1.0.0"
+description = "Servidor MCP em Python para busca acadêmica e exportação para revisão sistemática"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Erick Cardoso Mendes" }]
+keywords = ["mcp", "systematic-review", "bibliometrics", "vosviewer", "openalex", "crossref", "semantic-scholar"]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Science/Research",
+    "Natural Language :: Portuguese (Brazilian)",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+]
+# D-001: Linguagem do projeto: Python 3.10 ou mais
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=2,<3",
+    "httpx",
+    "typing_extensions",
+]
+
+[project.urls]
+Homepage = "https://github.com/Erick-wilding675/RSL-MCP-APP"
+Issues = "https://github.com/Erick-wilding675/RSL-MCP-APP/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "ruff",
+]
+
+[project.scripts]
+# D-008: Comando de entrada do servidor MCP
+rslapp = "rslapp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/rslapp"]
+
+# D-008: O pacote de código-fonte leva só o código, os testes, o README e a licença
+[tool.hatch.build.targets.sdist]
+include = ["src/rslapp", "tests", "README.md", "LICENSE", "pyproject.toml"]
+exclude = ["**/__pycache__"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

rslapp-1.0.0/src/rslapp/__init__.py

@@ -0,0 +1,4 @@
+"""RSL.app — Servidor MCP para revisão sistemática da literatura."""
+
+# D-001: Pacote principal em Python
+__version__ = "1.0.0"

rslapp-1.0.0/src/rslapp/config.py

@@ -0,0 +1,77 @@
+"""Configuração local do servidor RSL.app a partir de variáveis de ambiente."""
+
+from __future__ import annotations
+
+import os
+from dataclasses import dataclass, field
+from pathlib import Path
+
+DEFAULT_DATA_DIR_NAME = "RSL.app"
+DEFAULT_EXPORT_DIR_NAME = "exports"
+DEFAULT_CACHE_DAYS = 7
+
+
+# FR-07: Configuração do servidor e das chaves de API na máquina do usuário via variáveis de ambiente
+# NFR-02: Execução local (self-hosted), usando diretórios locais da máquina do usuário
+# NFR-03: O objeto de configuração guarda apenas se as chaves estão presentes (bool), nunca o valor delas
+@dataclass(frozen=True)
+class Config:
+    """Configuração imutável carregada do ambiente local."""
+
+    data_dir: Path
+    export_dir: Path
+    cache_days: int = DEFAULT_CACHE_DAYS
+    contact_email: str | None = field(default=None, repr=False)
+    openalex_key_configured: bool = False
+    semantic_scholar_key_configured: bool = False
+
+
+def _is_key_configured(env_var: str) -> bool:
+    """Verifica se uma chave de API está definida e não vazia sem reter seu valor (NFR-03)."""
+    raw = os.environ.get(env_var)
+    return bool(raw and raw.strip())
+
+
+def _parse_cache_days(raw_value: str | None) -> int:
+    """Valida e converte RSL_CACHE_DAYS para inteiro positivo."""
+    if raw_value is None:
+        return DEFAULT_CACHE_DAYS
+    try:
+        days = int(raw_value.strip())
+    except ValueError:
+        raise ValueError("RSL_CACHE_DAYS deve ser um inteiro positivo") from None
+    if days <= 0:
+        raise ValueError("RSL_CACHE_DAYS deve ser um inteiro positivo")
+    return days
+
+
+# FR-07: Leitura dinâmica da configuração a cada chamada, sem criar pastas nem reter chaves
+def load() -> Config:
+    """Lê as variáveis de ambiente e devolve a configuração atual."""
+    # NFR-02: Pastas locais padrão na conta do usuário
+    raw_data_dir = os.environ.get("RSL_DATA_DIR")
+    if raw_data_dir and raw_data_dir.strip():
+        data_dir = Path(raw_data_dir.strip()).expanduser()
+    else:
+        data_dir = Path.home() / DEFAULT_DATA_DIR_NAME
+
+    raw_export_dir = os.environ.get("RSL_EXPORT_DIR")
+    if raw_export_dir and raw_export_dir.strip():
+        export_dir = Path(raw_export_dir.strip()).expanduser()
+    else:
+        export_dir = data_dir / DEFAULT_EXPORT_DIR_NAME
+
+    cache_days = _parse_cache_days(os.environ.get("RSL_CACHE_DAYS"))
+
+    raw_email = os.environ.get("RSL_CONTACT_EMAIL")
+    contact_email = raw_email.strip() if raw_email and raw_email.strip() else None
+
+    # NFR-03: Apenas booleanos indicando presença das chaves são armazenados
+    return Config(
+        data_dir=data_dir,
+        export_dir=export_dir,
+        cache_days=cache_days,
+        contact_email=contact_email,
+        openalex_key_configured=_is_key_configured("OPENALEX_API_KEY"),
+        semantic_scholar_key_configured=_is_key_configured("SEMANTIC_SCHOLAR_API_KEY"),
+    )

rslapp-1.0.0/src/rslapp/core/__init__.py

@@ -0,0 +1,16 @@
+"""Miolo (core) do RSL.app: modelos e erros independentes do protocolo MCP."""
+
+from __future__ import annotations
+
+from rslapp.core.errors import ERROR_CODES, ErrorCode, RSLError
+from rslapp.core.models import Affiliation, Author, SourceResult, Work
+
+__all__ = [
+    "ERROR_CODES",
+    "Affiliation",
+    "Author",
+    "ErrorCode",
+    "RSLError",
+    "SourceResult",
+    "Work",
+]