Skip to main content

MCP server for a multilingual philosophy corpus — glossary, syntheses, thinker profiles, and articles in PT/EN/ES

Project description

philosophy-mcp

An MCP server for a multilingual philosophy corpus — glossary, syntheses, thinker profiles, and articles in Portuguese, English, and Spanish.

648 entries: ~270 glossary terms, 11 period syntheses, ~107 thinker profiles, and articles from Filosofia em Resumo.


Requirements

  • Python >= 3.10

Quick Start

Install from PyPI

pip install philosophy-mcp

Install with uv

uv pip install philosophy-mcp

Run directly with uvx (no install needed)

uvx philosophy-mcp

Use with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "filosofia": {
      "command": "uvx",
      "args": ["philosophy-mcp"]
    }
  }
}

Use with VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "filosofia": {
      "command": "uvx",
      "args": ["philosophy-mcp"]
    }
  }
}

That's it. The server connects to the public API automatically — no local files needed.


What can it do?

Ask your AI assistant anything about philosophy. The MCP tools give it access to a curated corpus:

  • "O que é eudaimonia?" → searches the glossary
  • "Tell me about Kant" → fetches the thinker profile
  • "¿Cuáles son las síntesis disponibles?" → lists period syntheses
  • "Search 'logos' across everything" → full-text search

Examples

Portuguese (default — lang="pt"):

"O que significa imperativo categórico?" "Me fale sobre Sócrates" "Quais são os períodos da filosofia?"

English (lang="en"):

"What is eudaimonia?" "Tell me about Aristotle's philosophy" "List all thinker profiles in English" "Search for 'virtue' in the glossary"

Spanish (lang="es"):

"¿Qué es el logos?" "Busca pensadores relacionados con el estoicismo" "Dame la síntesis del período medieval"

The assistant picks the language automatically based on your question, or you can ask explicitly: "Search 'categorical imperative' in the English glossary".

Available Tools

Tool Description
search_glossario(query, lang) Search glossary terms by keyword
get_glossario(slug, lang) Full definition of a term by slug
listar_glossario(lang) List all glossary terms
listar_sinteses(lang) List period syntheses
get_sintese(slug, lang) Full text of a period synthesis
listar_pensadores(lang) List all thinker profiles
buscar_pensador(query, lang) Search thinkers by name/keyword
get_pensador(slug, lang) Full thinker profile
listar_artigos(lang) List all articles
get_artigo(slug, lang) Full article by slug
search_artigos(query, lang) Search articles by keyword
search(query, lang, section) Full-text search across corpus
corpus_stats() Corpus statistics

lang: pt (default), en, es


Languages

All content is available in three languages:

Language Glossary Syntheses Thinkers Articles
Português (pt)
English (en)
Español (es)

Data Source

The server connects to the public API at filosofiaemresumo.com.br/api automatically.


Content Coverage

Periods (Syntheses)

  1. Pre-Socratics & Sophists (~600–400 BC)
  2. Socrates, Plato & Aristotle
  3. Hellenistic Philosophy
  4. Medieval Philosophy
  5. Humanism & Renaissance
  6. Scientific Revolution
  7. Rationalism & Empiricism
  8. Contractualism, Enlightenment & Kant
  9. German Idealism
  10. 19th Century Philosophy
  11. 20th Century Philosophy

Thinkers (~107 profiles)

From Thales of Miletus to Judith Butler — including Socrates, Plato, Aristotle, Descartes, Kant, Hegel, Marx, Nietzsche, Heidegger, Sartre, Foucault, and many more.

Glossary (~90 terms per language)

Key philosophical concepts: arché, eudaimonia, logos, phronesis, noumeno, Aufhebung, categorical imperative, will to power, and more.


License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

philosophy_mcp-0.1.3.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

philosophy_mcp-0.1.3-py3-none-any.whl (7.0 kB view details)

Uploaded Python 3

File details

Details for the file philosophy_mcp-0.1.3.tar.gz.

File metadata

  • Download URL: philosophy_mcp-0.1.3.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for philosophy_mcp-0.1.3.tar.gz
Algorithm Hash digest
SHA256 4752150670151a70cf45c2aeae9316c174e3443836c0d198a02f7abcbb9d3db1
MD5 15f874a6c85540452eb85e874148f7f2
BLAKE2b-256 5b6f15ab2c44063de60ce1b432272c4692b68831e6418a6dab3a2dcf767d9bcc

See more details on using hashes here.

File details

Details for the file philosophy_mcp-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: philosophy_mcp-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 7.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.5

File hashes

Hashes for philosophy_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 460ac46166d8b2b3577929bd713eef904eba5ded4afb6e91b7e1bdfc33e0825c
MD5 31f32d387931db21e4d7a1ab0e61d1f7
BLAKE2b-256 a635bd8a09a4e06f4f106b812114367a8c5338ee0b4d03d77cb639aa68c4f4b6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page