Learning Assistant MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Learning Assistant MCP Server
MCP capability server consumed by AI-Learning-Assistant-Service.
AI Learning Assistant ──MCP / Streamable HTTP──▶ this server ──▶ Web Search Provider (Tavily)Design doc: dev-docs/web-search-mcp-integration.md.
Capabilities
Tool | Purpose |
| Ranked public-web results (title, URL, snippet, score) for current/external info. |
Related MCP server: agent-web-search-mcp
Setup
uv sync
cp .env.example .env # then fill MCP_AUTH_TOKEN and TAVILY_API_KEYMCP_AUTH_TOKEN must match the assistant's MCP_SERVER_AUTH_TOKEN.
TAVILY_API_KEY lives only here — never in the assistant.
Run
uv run python -m app.main # Streamable HTTP on :8006 → POST/GET /mcp/Health check: GET http://localhost:8006/health.
Transport
Streamable HTTP (transport="http"). Single endpoint, works across independently
deployed services and through the Nginx gateway. Clients authenticate with
Authorization: Bearer <MCP_AUTH_TOKEN>.
Access path | MCP endpoint | Health |
Direct (service-to-service) |
|
|
Via API gateway |
|
|
Use the no-trailing-slash /mcp form; the server redirects /mcp/ → /mcp.
Layout
app/
main.py # composition root: FastMCP + auth + tool registration + /health
config.py # pydantic-settings
logging_config.py # structured JSON logging
auth.py # StaticBearerVerifier (shared-secret, constant-time)
rate_limit.py # in-process token bucket
schemas.py # WebSearchInput / WebSearchResultItem / WebSearchResponse
tools/web_search.py # register_web_search(mcp, provider, settings)
providers/
base.py # WebSearchProvider protocol + ProviderResult + errors
tavily.py # TavilyProvider
__init__.py # get_provider(settings) factoryAdding a tool
app/tools/<name>.pywithregister_<name>(mcp, deps).Call it from
app/main.py.If it wraps an external API, add a provider under
app/providers/.
No transport/auth/architecture changes required.
Tests
uv run pytest # unit
uv run pytest -m integration # hits Tavily; needs TAVILY_API_KEY
uv run ruff check .Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Provides AI assistants with access to Seltz's powerful Web Search capabilities.
Enable AI assistants to perform web searches using Perplexity's Sonar Pro.
LLM-ready web search + instant answers + URL-to-clean-text fetch for agents and RAG.
Search Google straight from your AI agent. Web results, images, videos, news, products, scholarly ar
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables web search and webpage content fetching with SSRF protections, returning structured results.MIT
- FlicenseAqualityDmaintenanceEnables MCP-compatible agents to perform web searches via the agent-web-search engine, returning ranked results with sources.1-
- AlicenseAqualityDmaintenanceEnables MCP hosts to perform cited web searches and receive source-bearing results with titles, URLs, snippets, and sources for evidence-grounded answers.136 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to perform live web searches with ranked results and extracted page passages, plus clean markdown extraction of any URL.MIT