examples/client: add a remote search and fetch example with Parallel MCP
Los mantenedores suelen responder en 1 día
Nadie ha tomado este issue todavía.
Evaluación
- Dificultad
- 2/5
- Tiempo estimado
- 1-3 horas
- Aptitud para principiantes
- 76/100
Línea de trabajo
Empieza en examples/client/ y lee los ejemplos existentes listfeatures y loadtest para ver cómo usan StreamableClientTransport y CallTool. Después, añade un ejemplo específico para https://search.parallel.ai/mcp que descubra y llame a web_search o web_fetch; incluye instrucciones de configuración, gestión de tiempos de espera y errores, y pruebas con un servidor MCP local. Se considera terminado cuando los comandos documentados funcionan con el endpoint anónimo y las pruebas cubren ambas llamadas a herramientas.
Escrito por el modelo de indexación a partir del texto del issue.
Descripción
Is your feature request related to a problem? Please describe.
The client examples cover remote feature discovery, HTTP load testing, and calls to a local HTTP server. A focused example for one remote search or page-fetch call would make it easier to learn tool discovery, invocation, and result handling without configuring a load test.
Describe the solution you'd like
Add a small example under examples/client/ using the existing StreamableClientTransport and CallTool APIs with Parallel Search MCP at https://search.parallel.ai/mcp. It would accept a search query or page URL, discover the tools, invoke web_search or web_fetch, and print the returned content. The service provides free, keyless search in Fast mode and page fetching, with anonymous rate limits.
Keep this confined to the example, with no SDK API changes or new dependencies. Include setup instructions, a bounded request timeout, error handling, and tests using a local MCP server. Validate both documented commands against the anonymous endpoint before submitting the implementation.
Describe alternatives you've considered
examples/client/listfeatures already accepts a remote HTTP endpoint, but only lists features. examples/http demonstrates tool calls against a local server. examples/client/loadtest can call a remote tool with JSON arguments, but is designed for repeated concurrent calls and throughput statistics. The proposed example would focus on a single search or page fetch and readable output.
Additional context
This issue precedes implementation as requested by the contribution guide for nontrivial changes. I work at Parallel. AI assistance was used to research the repository and draft this issue.
- Lenguaje dominante
- Go
- Estrellas
- 5.2k
- Forks
- 583
- Merge medio
- 2 d 1 h
- PR fusionados (30 d)
- 55
Preparar el entorno
Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.
- Sin Dockerfile ni archivo de Docker Compose
- Tiene una plantilla de pull request
- Leer la guía de contribución
Primeros pasos
- Lee el issue completo y luego la guía de contribución del proyecto.
- Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
- Haz un fork del repositorio y trabaja en una rama.
- Abre un pull request que haga referencia al número del issue.
Más de modelcontextprotocol/go-sdk
-
Session-lifecycle bookkeeping logs at info, spamming multiple log lines per request on stateless streamable HTTPPosiblemente ocupada @anneheartrecord la tomó hace 49 días. AbiertoP3
Dificultad 2/5 1-3 horas Aptitud para principiantes 75/100
modelcontextprotocol/go-sdk#1204 · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Expose generic `SendNotification` on `ServerSession` for custom protocol extensionsPosiblemente ocupada @ajuijas la tomó hace 215 días. Abiertoneeds investigation
Dificultad 2/5 1-3 horas Aptitud para principiantes 72/100
modelcontextprotocol/go-sdk#745 · 13 comentarios · 1 reacción ·
Los mantenedores suelen responder en 1 día
-
Dificultad 3/5 1-2 días Aptitud para principiantes 50/100
modelcontextprotocol/go-sdk#1406 · 1 comentario ·
Los mantenedores suelen responder en 1 día
-
jsonrpc: decimal and exponent integer IDs still lose precision after #1401Posiblemente ocupada @skosovsky la tomó hoy. Abierto
Dificultad 3/5 1-2 días Aptitud para principiantes 25/100
modelcontextprotocol/go-sdk#1404 · 2 comentarios ·
Los mantenedores suelen responder en 1 día
-
mcp: a handler error without a code reaches the peer as JSON-RPC error code 0Posiblemente ocupada @talhayme la tomó hoy. Abierto
Dificultad 4/5 3-5 días Aptitud para principiantes 35/100
modelcontextprotocol/go-sdk#1394 · 4 comentarios · 1 asignado ·
Los mantenedores suelen responder en 1 día
Todos los issues de modelcontextprotocol/go-sdk
Issues similares
-
enhancement
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
Los mantenedores suelen responder en 2 días
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 70/100
superplanehq/superplane#8604 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 68/100
Los mantenedores suelen responder en 1 día
-
documentation hacktoberfest priority: low skill: good first issue status: ready for dev
Dificultad 2/5 Medio día Aptitud para principiantes 85/100
hyperledger-labs/fabric-smart-client#2142 ·
Los mantenedores suelen responder en 1 día
-
Dificultad 2/5 1-3 horas Aptitud para principiantes 78/100
numberly/vault-db-injector#107 ·
Los mantenedores suelen responder en 1 día