TheAlmanac
Provides tools to search, retrieve, and manage Python documentation from the official Python docs.
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.
TheAlmanac
A documentation assistant leveraging Model Context Protocol (MCP) to help programmers access the most up-to-date and relevant information from API and software documentation.
Features
Documentation Crawler: Automatically download and store documentation locally
Simple Search: Find relevant documentation sections quickly
MCP Integration: Provide LLMs with tools to access documentation
File-based Storage: Efficiently organize documentation in a simple file structure
MCP Server: HTTP server for LLM tool access
Related MCP server: Snippy
Installation
# Clone the repository
git clone https://github.com/yourusername/TheAlmanac.git
cd TheAlmanac
# Install dependencies with UV
uv pip install -e .Usage
Managing Documentation Sources
# Add a documentation source
almanac add python https://docs.python.org/3/
# List all documentation sources
almanac list
# Download documentation
almanac download python
# Remove a documentation source
almanac remove pythonSearching Documentation
# Search all documentation
almanac search "context manager"
# Search a specific source
almanac search "context manager" --source python
# Search with more context
almanac search "context manager" --context-lines 5Running the MCP Server
# Start the HTTP server (for direct API access)
almanac serve --transport http
# Start the MCP server (for integration with MCP clients like Claude for Desktop)
almanac serve --transport stdio
# Start on a specific host and port (for HTTP transport)
almanac serve --transport http --host 0.0.0.0 --port 9000MCP Tools
TheAlmanac provides the following MCP tools:
search_documentation: Search for relevant documentation
get_documentation: Get a specific document or section
download_documentation: Download a new documentation source
list_documentation: List available documentation sources
Example Scripts
The scripts directory contains example scripts for testing and demonstrating TheAlmanac:
test_mcp_tools.py: Directly test MCP toolstest_mcp_server.py: Test the MCP server with HTTP requeststest_mcp_fastmcp.py: Test the FastMCP implementation directlyexample_workflow.py: Run a complete workflow example
Example MCP Tool Usage
# Test the search tool (HTTP server)
./scripts/test_mcp_tools.py search "installation"
# Test getting a specific document (HTTP server)
./scripts/test_mcp_tools.py get python index.md
# Test the search tool (FastMCP)
./scripts/test_mcp_fastmcp.py search "installation"
# Test listing documentation (FastMCP)
./scripts/test_mcp_fastmcp.py list
# Test the complete workflow
./scripts/example_workflow.pyMCP Integration with Claude for Desktop
To integrate TheAlmanac with Claude for Desktop:
Make sure Claude for Desktop is installed
Edit the Claude for Desktop configuration file:
# For macOS: code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonAdd TheAlmanac as an MCP server:
{ "mcpServers": { "the-almanac": { "command": "/path/to/python", "args": [ "-m", "almanac.cli.commands", "serve", "--transport", "stdio" ] } } }Restart Claude for Desktop
Look for the hammer icon to access TheAlmanac tools
Development
# Install development dependencies
uv pip install -e ".[dev]"
# Run tests
uv run pytestAdding Dependencies
# Add a production dependency
uv add package_name
# Add a development dependency
uv add --dev package_nameLicense
MIT
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
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
Search the official docs of Claude Code, Cursor, OpenAI Codex and MCP, refreshed daily.
Docsy gives AI assistants current, version-specific documentation for libraries, frameworks and SDKs. Resolve library IDs and versions, then search and fetch focused official documentation with original source links using five read-only MCP tools. Hosted Streamable HTTP with OAuth 2.1 sign-in.
An MCP server that gives your AI access to the source code and docs of all public github repos
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access up-to-date documentation by indexing GitHub repositories and official docs, providing semantic search through MCP.24 npm7MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to save, retrieve, and semantically search code snippets, generate code style guides and deep wiki documentation, and orchestrate multi-agent documentation workflows through MCP tools.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to save and retrieve code snippets, perform semantic code search, generate language-specific style guides, create comprehensive wiki documentation, and orchestrate multi-agent documentation workflows through MCP tools.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to save and retrieve code snippets, generate language-specific style guides, create wiki documentation, and orchestrate multi-agent documentation workflows through MCP tools with semantic search.-