mcp-server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server what tools are available?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP por Reynaldo Vieira
Este repositório contém uma implementação de um servidor de Protocolo de Contexto de Modelo (MCP) para fins educacionais e de demonstração, criado por Reynaldo Vieira. Este código demonstra como construir um servidor MCP funcional que pode se integrar a vários clientes LLM.
Principais Benefícios
Uma lista crescente de integrações pré-construídas que seu LLM pode conectar diretamente
Flexibilidade para alternar entre provedores e fornecedores de LLM
Melhores práticas para proteger seus dados em sua infraestrutura
Visão Geral da Arquitetura
O MCP segue uma arquitetura cliente-servidor, onde uma aplicação hospedeira pode se conectar a vários servidores:
Hospedeiros MCP: Programas como Claude Desktop, IDEs ou ferramentas de IA que desejam acessar dados através do MCP
Clientes MCP: Clientes de protocolo que mantêm conexões 1:1 com os servidores
Servidores MCP: Programas leves que expõem capacidades específicas através do Protocolo de Contexto de Modelo padronizado
Fontes de Dados: Serviços locais (arquivos, bancos de dados) e remotos (APIs) que os servidores MCP podem acessar
Related MCP server: MCP Weather Server
Conceitos Centrais do MCP
Os servidores MCP podem fornecer três tipos principais de capacidades:
Recursos: Dados semelhantes a arquivos que podem ser lidos por clientes (como respostas de API ou conteúdo de arquivos)
Ferramentas: Funções que podem ser chamadas pelo LLM (com a aprovação do usuário)
Prompts: Modelos pré-escritos que ajudam os usuários a realizar tarefas específicas
Requisitos do Sistema
Python 3.10 ou superior
MCP SDK 1.2.0 ou superior
Gerenciador de pacotes
uv
Começando
Instalando o gerenciador de pacotes uv
No MacOS/Linux:
curl -LsSf https://astral.sh/uv/install.sh | shCertifique-se de reiniciar seu terminal para garantir que o comando uv seja reconhecido.
Configuração do Projeto
Crie e inicialize o projeto:
# Crie um novo diretório para o nosso projeto
uv init mcp-server
cd mcp-server
# Crie e ative o ambiente virtual
uv venv
source .venv/bin/activate # No Windows, use: .venv\Scripts\activate
# Instale as dependências
uv add "mcp[cli]" httpxCrie o arquivo de implementação do servidor:
touch main.pyExecutando o Servidor
Inicie o servidor MCP:
uv run main.pyO servidor será iniciado e estará pronto para aceitar conexões.
Conectando ao Claude Desktop
Instale o Claude Desktop a partir do site oficial.
Configure o Claude Desktop para usar seu servidor MCP:
Edite ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"mcp-server-reynaldo": {
"command": "uv", # É melhor usar o caminho absoluto para o comando uv
"args": [
"--directory",
"/CAMINHO/ABSOLUTO/PARA/SEU/mcp-server",
"run",
"main.py"
]
}
}
}Reinicie o Claude Desktop.
Solução de Problemas
Se o seu servidor não estiver sendo reconhecido pelo Claude Desktop:
Verifique o caminho e as permissões do arquivo de configuração.
Verifique se o caminho absoluto na configuração está correto.
Certifique-se de que o
uvestá instalado corretamente e acessível.Verifique os logs do Claude Desktop para mensagens de erro.
Licença
Este projeto está licenciado sob a Licença MIT. Veja o arquivo LICENSE para mais detalhes.
Available Tools
1 toolobter_documentacao_reynaldoB
Busca a documentação mais recente para uma determinada consulta e biblioteca. Suporta langchain, openai e llama-index.
Args: query: A consulta a ser pesquisada (por exemplo, "Chroma DB") library: A biblioteca para pesquisar (por exemplo, "langchain")
Returns: Texto da documentação
Inputs: query (required), library (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no risk of confusion between tools. The tool's purpose is clear and distinct as the sole operation.
The single tool uses a consistent verb_noun pattern (obter_documentacao_reynaldo), and there are no other tools to introduce inconsistency.
A single tool is borderline thin for a standalone server; it covers a narrow purpose but may leave users wanting more functionality, such as listing available libraries or supporting additional operations.
For its stated purpose (fetching documentation for specific libraries: langchain, openai, llama-index), the tool is complete. It handles both query and library selection via arguments, covering the full lifecycle of a documentation lookup.
Maintenance
Related MCP Connectors
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Related MCP Servers
- AlicenseBqualityDmaintenanceAn educational implementation of a Model Context Protocol server that demonstrates how to build a functional MCP server for integrating with various LLM clients like Claude Desktop.1162MIT
- AlicenseBqualityDmaintenanceA demonstration MCP server created for learning purposes, allowing Claude AI to interact with local files and a Postgres database while implementing a custom Model Context Protocol.1ISC
- FlicenseBqualityDmaintenanceA demonstration MCP (Model Control Protocol) server built with FastMCP framework that allows integration with Claude Desktop, Cursor, and Claude Code IDEs.5-
- AlicenseAqualityDmaintenanceA demonstration MCP server for local development and testing with Claude Desktop on WSL. Provides basic utility tools including greeting messages, echo functionality, and server information retrieval.3MIT