[{"_1":2,"_286":-5,"_287":-5},"loaderData",{"_3":4,"_24":25,"_205":206},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":22,"_23":-5},"attributes",[15],"bot","id",28696684,"membership","referenceId","019acd2b-7918-736f-b37c-c39fdfea91a9","unreadReleaseNotesCount",2,"userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_28":-5,"_29":30,"_31":43,"_123":124,"_204":106},"availableLocales",[],"githubUser","locale",{"_31":32,"_39":40,"_41":42},"mcpServer",{"_33":34,"_35":36,"_37":38},"description","A Model Context Protocol (MCP) server implementation built with Python and FastAPI for educational purposes. Demonstrates MCP server functionality through a books API interface.","displayName","BooksAPI-MCP","readme","# 🤖 BooksAPI-MCP\n\n $\"Python\"$ \n $\"FastAPI\"$ \n $\"MariaDB\"$ \n $\"Model$ \n $\"Visual$ \n\nEsse projeto foi criado por um estudo explorando o Protocolo de Contexto de Modelo (MCP), aplicado em Python e FastAPI, visando entender a sua utilização.\n\nAlém disso, ressalta-se que todo o conhecimento adquirido foi por meio de vídeos no Youtube acerca do assunto, mesmo sendo tratado em outras linguagens como Typescript, ainda é útil para entender a sua aplicação em um contexto de Cliente x Servidor.\n\n## 💻 Pré-requisitos\nPara adiantar uma etapa, verifique se você possui todos os requisitos:\n\n- Você possui instalado uma versão estável da linguagem `python`.\n- Você possui instalado uma versão estável do `git`.\n- Você possui instalado um ambiente de desenvolvimento, como `Visual Studio Code` ou outro de sua preferência.\n\n## 🚀 Instalando as dependências\nPara instalar as dependências, comece instalando o `pipx`:\n\n```bash\n(WINDOWS)\npy -m pip install pipx\n\n(LINUX UBUNTU)\nsudo apt update\nsudo apt install pipx\npipx ensurepath\n```\n\nApós isso, realize a instalação do `uv`:\n```bash\npipx install uv\n```\n\nEm seguida, vá para a pasta que deseja clonar esse repositório e digite:\n```bash\ngit clone https://github.com/SepulvedaRafael/booksapi-mcp.git\n```\n\nApós a clonagem, navegue até a pasta que foi gerada e execute cada um dos comandos abaixo:\n```bash\nuv venv\n\n(WINDOWS)\n.venv\\Scripts\\activate\n\n(LINUX)\nsource .venv/bin/activate\n\nuv pip install -r pyproject.toml\nuv sync\n```\n\n## 🔓 Execução do db.py\nPara executar os programas corretamente e sem erros, certifique-se de ter o MariaDB Client instalado e que você lembre da suas credenciais. Assim, crie um arquivo com nome .env apenas e adicione:\n\n```bash\nUSER_DB = root\nPASSWORD_DB = password_db\nHOST_DB = localhost\nPORT_DB = 3306\nNAME_DB = booksapi\n```\n\nApós essa configuração, basta executar o programa `db.py`.\n\n\n## 💻 Execução via FastAPI + uvicorn\nPara executar esse código via FastAPI e uvicorn, para visualizar ou certificar que a API está funcionando, certifique de estar dentro da pasta /src e executar esse comando:\n```bash\nuvicorn api:app --reload\n```\n\nCaso queira fazer algumas requisições para saber se os endpoints estão funcionando, fique a vontade para executar o comando acima e ir na pasta `requests`. Certifique-se de ter a extensão REST Client (VScode ou Cursor) instalado e clique siga a ordem: POST, GET, PUT e DELETE. Para executar cada um desses arquivos, basta clicar em `Send request`.\n\n## 🤖 Execução via FastMCP + VSCode\nPar executar esse código via FastMCP com VSCode, pressione: `CTRL`+ `SHIFT` + `P`. Quando abrir a janela, digite `MCP: Adicionar Servidor`.\n\nEm seguida, clique em Comando (stdio).\n\nA seguir, busque o caminho completo para a pasta /src. Lembre-se que em Windows é `\\`.\n\nComo comando do stdio você irá colocar:\n```bash\nuv --directory run api.py\n```\n\nEm seguida, coloque um nome para o seu servidor MCP.\n\nE escolha o tipo de configuração se vai ser Global ou no Workspace. Eu prefiro no Global.\n\nPor fim, você será redirecionado pra basta `mcp.json`, com o código mais ou menos assim:\n\n```json\n{\n \"servers\": {\n \"booksapi\": {\n \"type\": \"stdio\",\n \"command\": \"uv\",\n \"args\": [\n \"--directory\",\n \"\",\n \"run\",\n \"api.py\"\n ]\n }\n },\n \"inputs\": []\n}\n```\n\nLogo acima, terá um botão escrito Início e do lado deveria estar aparecendo 5 ferramentas ou tools. Isso significa que ele reconheceu certinho o seu servidor MCP. Assim, inicie o servidor MCP e caso queira checar está funcionando devidamente, pressione: `CTRL` + `SHIFT` + `U`, isso irá abrir o `OUTPUT` ou `SAÍDA`.\n\nAo lado do filtro terá uma lista suspensa onde você deverá buscar por: `MCP: nome do seu servidor`. Caso não apareça, vá no arquivo `mcp.json` e clique em `Mais...`, depois vá em `Mostrar saída`.\n\nPara utilizá-lo, basta abrir o Chat, colocar em Agente ao invés de Ask e pressionar na opção que aparece duas ferramentas cruzadas. Nela, deixe selecionado apenas o seu servidor MCP e clique em OK.\n\nPor fim, basta solicitar alguma ação, como adicionar um livro, atualizar algo do livro, deletar o livro, consultar os livros e consultar a quantidade de livros. Quando fizer alguma dessas solicitações, ele irá pedir permissão para cada execução.\n\n\n> [!IMPORTANT]\n> Para o MCP funcionar no VSCode, acredito que seja necessário ter o Github Copilot, Github Copilot Chat e o Python como extensões.","name","English","tag","en-US",{"_44":45,"_13":46,"_52":34,"_53":34,"_35":36,"_16":54,"_55":56,"_57":58,"_66":-5,"_67":68,"_69":-5,"_70":71,"_112":113,"_118":-5,"_65":95,"_119":68,"_97":120,"_121":122},"addedAt","2025-09-28T02:01:18.722067Z",[47,48,49,50,51],"category:developer-tools","category:databases","category:education-and-learning-tools","language:python","license_grade:a","descriptionMarkdown","descriptionPlainText",12029,"integrations",[],"namespace",{"_59":60,"_65":64},"owner",{"_61":62},"githubAccount",{"_63":64},"login","SepulvedaRafael","slug","readmeMarkdown","recentUsage",0,"redditPostExternalId","repository",{"_72":73,"_80":81,"_84":85,"_104":-5,"_105":106,"_107":-5,"_108":109},"argumentsJsonSchema",{"_74":75,"_76":77,"_78":79},"properties",{},"required",[],"type","object","githubProject",{"_37":38,"_82":83},"url","https://github.com/SepulvedaRafael/booksapi-mcp","githubRepository",{"_86":87,"_88":89,"_90":91,"_16":92,"_93":94,"_39":95,"_59":96,"_99":68,"_100":101,"_103":68},"defaultBranch","master","fullName","SepulvedaRafael/booksapi-mcp","githubTreeId",445118,28433,"language","Python","booksapi-mcp",{"_63":64,"_97":98},"uid","t52yk18rcz","recentStargazers","spdxLicense",{"_39":102},"MIT License","stargazers","glamaJson","inspectable",false,"npmPackage","supportedPlatforms",[110,111],"WINDOWS","LINUX","scores",{"_114":115,"_116":-5,"_117":-5},"license",100,"quality","security","simpleIcon","toolCount","gbeuii66hq","updatedAt","2025-11-23T06:01:21.382624Z","meta",[125,128,130,137,140,142,145,148,151,154,157,159,162,165,167,169,171,173,175],{"_126":127},"title","BooksAPI-MCP | Glama",{"_129":34,"_39":33},"content",{"_131":132,"_133":134,"_135":136},"href","https://glama.ai/mcp/servers/@SepulvedaRafael/booksapi-mcp","rel","canonical","tagName","link",{"_129":36,"_138":139},"property","og:title",{"_129":34,"_138":141},"og:description",{"_129":143,"_138":144},"https://glama.ai/logo.png","og:logo",{"_129":146,"_138":147},"https://glama.ai/mcp/servers/@SepulvedaRafael/booksapi-mcp/og-image","og:image",{"_129":149,"_138":150},"630","og:image:height",{"_129":152,"_138":153},"1200","og:image:width",{"_129":155,"_138":156},"website","og:type",{"_129":132,"_138":158},"og:url",{"_129":160,"_138":161},"Glama – MCP Hosting Platform","og:site_name",{"_129":163,"_39":164},"summary_large_image","twitter:card",{"_129":160,"_39":166},"twitter:title",{"_129":34,"_39":168},"twitter:description",{"_129":146,"_39":170},"twitter:image",{"_129":149,"_39":172},"twitter:image:height",{"_129":152,"_39":174},"twitter:image:width",{"_176":177},"script:ld+json",{"_178":179,"_180":181},"@context","http://schema.org","@graph",[182],{"_178":183,"_184":185,"_186":187},"https://schema.org","@type","BreadcrumbList","itemListElement",[188,195,198,202],{"_184":189,"_190":191,"_39":192,"_193":194},"ListItem","item","https://glama.ai/","Glama","position",1,{"_184":189,"_190":196,"_39":197,"_193":22},"https://glama.ai/mcp","MCP",{"_184":189,"_190":199,"_39":200,"_193":201},"https://glama.ai/mcp/servers","Servers",3,{"_184":189,"_190":132,"_39":36,"_193":203},4,"visitorIsMaintainer","routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_207":208,"_31":214,"_230":231,"_123":245,"_242":269,"_270":271},"blob",{"_129":209,"_210":211,"_212":213},"DELETE http://127.0.0.1:8000/livros/2\n","fileName","delete.http","size",38,{"_44":45,"_13":215,"_52":34,"_53":34,"_35":36,"_16":54,"_55":216,"_57":217,"_66":-5,"_67":68,"_69":-5,"_70":220,"_112":229,"_118":-5,"_65":95,"_119":68,"_97":120,"_121":122},[47,48,49,50,51],[],{"_59":218,"_65":64},{"_61":219},{"_63":64},{"_72":221,"_80":224,"_84":225,"_104":-5,"_105":106,"_107":-5,"_108":228},{"_74":222,"_76":223,"_78":79},{},[],{"_37":38,"_82":83},{"_86":87,"_88":89,"_90":91,"_16":92,"_93":94,"_39":95,"_59":226,"_99":68,"_100":227,"_103":68},{"_63":64,"_97":98},{"_39":102},[110,111],{"_114":115,"_116":-5,"_117":-5},"member",{"_232":233,"_236":237,"_238":239,"_90":240,"_241":106,"_242":211,"_243":244,"_212":213,"_78":207},"commit",{"_234":235},"sha","34da1261e1c7b94a10e8d653b3f6653a06b7f228","contentStoredObjectPointerId",13602346,"fullPath","requests/delete.http",445116,"indexable","path","safeToDisplayAsText",true,[246,248,250,252,254,255,256,258,259,260,261,262,263,264,265,266,267,268],{"_126":247},"delete.http | BooksAPI-MCP | Glama",{"_129":249,"_39":33},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_131":251,"_133":134,"_135":136},"https://glama.ai/mcp/servers/@SepulvedaRafael/booksapi-mcp/blob/34da1261e1c7b94a10e8d653b3f6653a06b7f228/requests",{"_129":253,"_138":139},"delete.http | BooksAPI-MCP",{"_129":249,"_138":141},{"_129":143,"_138":144},{"_129":257,"_138":147},"https://glama.ai/generated-images/og?title=delete.http+%7C+BooksAPI-MCP",{"_129":149,"_138":150},{"_129":152,"_138":153},{"_129":155,"_138":156},{"_129":251,"_138":158},{"_129":160,"_138":161},{"_129":163,"_39":164},{"_129":160,"_39":166},{"_129":249,"_39":168},{"_129":257,"_39":170},{"_129":149,"_39":172},{"_129":152,"_39":174},"requests","treeMembers",[272,274,278,282],{"_232":273,"_238":239,"_242":211,"_78":207},{"_234":235},{"_232":275,"_238":276,"_242":277,"_78":207},{"_234":235},"requests/get.http","get.http",{"_232":279,"_238":280,"_242":281,"_78":207},{"_234":235},"requests/post.http","post.http",{"_232":283,"_238":284,"_242":285,"_78":207},{"_234":235},"requests/put.http","put.http","actionData","errors"]

MCP directory API