convez.ai
MCP ServerBusca & PesquisaIntermediário
monirul8888

MCP Search Service

monirul8888/mcp-search-service

Busca em documentação oficial com MCP e Serper API

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP leve para buscas na web e agregação de resultados, com suporte para documentação oficial de bibliotecas populares como LangChain, LlamaIndex, OpenAI e UV. Utiliza a API Serper para buscar e limpar conteúdo de páginas, retornando resultados prontos para leitura por agentes de IA.

Instalação

$npx convez-ai monirul8888/mcp-search-service

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Agentes Claude consultando documentação de bibliotecas em tempo real
  • Integração de busca estruturada em sistemas MCP
  • Extração e limpeza de conteúdo técnico para LLMs

Veredito

Projeto funcional e bem estruturado para conectar Claude a documentação oficial via MCP. Implementação async com FastMCP é sólida, mas o suporte a apenas 4 bibliotecas pré-configuradas limita o alcance geral de buscas — ideal para fluxos específicos em documentação técnica conhecida.

README

A tradução para o português deste README ainda está na fila.

Docs MCP Server

An AI-powered MCP (Model Context Protocol) server that searches official documentation, scrapes content, and returns clean AI-readable results for LLM agents.

Built with:

  • Python
  • FastMCP
  • Serper API
  • HTTPX
  • AsyncIO

Features

  • Search official documentation using Google Serper API
  • Fetch and clean webpage content
  • Async architecture with httpx
  • MCP-compatible tool server
  • Supports multiple documentation providers
  • Works with Claude Desktop MCP

Supported Documentation Sources

LibraryDocs
LangChainhttps://python.langchain.com
LlamaIndexhttps://docs.llamaindex.ai
OpenAIhttps://platform.openai.com
UVhttps://docs.astral.sh

Project Structure

mcp-search-service/
│
├── mcp_server.py
├── client.py
├── utils.py
├── .env
├── pyproject.toml
├── requirements.txt
└── README.md

Installation

1. Clone Repository

git clone https://github.com/yourusername/mcp-search-service.git
cd mcp-search-service

2. Create Virtual Environment

Using uv:

uv venv

Activate environment:

Windows

.venv\Scripts\activate

Linux/macOS

source .venv/bin/activate

3. Install Dependencies

Using uv:

uv sync

Or using pip:

pip install -r requirements.txt

Environment Variables

Create a .env file:

SERPER_API_KEY=your_serper_api_key
GROQ_API_KEY=your_groq_api_key

Run MCP Server

python mcp_server.py

Claude Desktop MCP Configuration

Add this configuration to Claude Desktop MCP settings:

{
  "mcpServers": {
    "docs-mcp": {
      "command": "python",
      "args": ["mcp_server.py"],
      "cwd": "D:\\Python\\MCP\\mcp-search-service",
      "env": {
        "SERPER_API_KEY": "your_serper_api_key",
        "GROQ_API_KEY": "your_groq_api_key"
      }
    }
  }
}

Available MCP Tool

get_docs

Search official documentation and return clean readable content.

Parameters

NameTypeDescription
querystringSearch query
librarystringSupported library name

Example

await get_docs(
    query="Publish package with uv",
    library="uv"
)

Example Output

SOURCE: https://docs.astral.sh/uv/guides/package/

Publishing packages with uv...

Supported Libraries

docs_urls = {
    "langchain": "python.langchain.com",
    "llama-index": "docs.llamaindex.ai",
    "openai": "platform.openai.com",
    "uv": "docs.astral.sh"
}

Tech Stack

  • FastMCP
  • HTTPX
  • AsyncIO
  • Python Dotenv
  • Serper API

Future Improvements

  • RAG support with ChromaDB
  • Multi-page crawling
  • AI summarization
  • Streaming responses
  • Markdown extraction
  • Vector search
  • Agent memory

Security Notes

  • Never expose API keys publicly
  • Store secrets in .env
  • Rotate keys if accidentally committed

License

MIT License


Author

Md. Monirul Islam

Ver o original no GitHub

Bom para

Relacionados