APLCart MCP Server
About
An MCP server providing semantic search capabilities for APLCart data.
Details
- Author
- xpqz
- Categories
- Search, Other, Knowledge Base
Jump to
Setup
Install APLCart MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/xpqz/ac-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
A Model Context Protocol (MCP) server that exposes theAPLCartidiom collection with semantic search capabilities. APLCart is a searchable collection of APL expressions with descriptions.
- Find APL expressions by exact syntax match
- Search across syntax, descriptions, and keywords
- Get keywords for specific APL expressions
- Natural language queries using OpenAI embeddings
- Python 3.11 or higher
- OpenAI API key (for semantic search functionality)
# Install uv if you haven't already curl -LsSf https://astral.sh/uv/install.sh | sh # Clone the repository git clone <repository-url> cd ac-mcp # Install dependencies uv sync
First, fetch and convert the APLCart TSV data to JSONL format:
# Using uv uv run python aplcart2json.py # Or with activated venv python aplcart2json.py # Optional: Generate SQLite database for faster searches python aplcart2json.py --db
Generate Embeddings (Optional; for Semantic Search)
To enable semantic search functionality:
# Set your OpenAI API key export OPENAI_API_KEY='your-api-key-here' # Generate embeddings uv run python generate_embeddings.py # Or with activated venv python generate_embeddings.py
- aplcart.index- FAISS index file containing embeddings
- aplcart_metadata.pkl- Metadata for semantic search results
# Basic usage uv run python aplcart_mcp_semantic.py # With SQLite database backend APLCART_USE_DB=1 uv run python aplcart_mcp_semantic.py
The project includes a.mcp.json.templatefile that automatically configures the MCP server. Save that as.mcp.json, update it with your details, and run/mcpin Claude Code to see available servers.
claude mcp add aplcart "uv run python aplcart_mcp_semantic.py"
Add this to your Claude Desktop configuration file:
- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%APPDATA%\Claude\claude_desktop_config.json
- Linux:~/.config/claude/claude_desktop_config.json
{ "mcpServers": { "aplcart": { "command": "uv", "args": [ "run", "--directory", "YOUR/PATH/HERE/ac-mcp", "python", "aplcart_mcp_semantic.py" ], "env": { "APLCART_USE_DB": "1", "OPENAI_API_KEY": "${OPENAI_API_KEY}" } } } }
Then restart Claude Desktop to load the MCP server.
-
lookup-syntax- Exact match on APL syntax
search- Substring search across syntax, description, and keywords
Example: search "matrix" limit=10
keywords-for- Get keywords for a specific syntax
Example: keywords-for "∘.≤⍨∘⍳"
semantic-search- Natural language search using embeddings
Example: semantic-search "how to split a string on a separator"
You can also use the semantic search functionality directly:
# Interactive mode uv run python search_embeddings.py # Single query uv run python search_embeddings.py "find the largest number" # JSON output uv run python search_embeddings.py "reverse an array" --json # More results uv run python search_embeddings.py "matrix operations" -k 10
- Type your query and press Enter to search
- Typequit,exit, orqto exit (or Ctrl+D or Ctrl+C)
- OPENAI_API_KEY- Required for semantic search functionality
- APLCART_USE_DB- Set to1,true, oryesto use SQLite database backend
ac-mcp/ ├── aplcart.jsonl # Converted APLCart data (run aplcart2json.py to generate) ├── aplcart.db # SQLite database (optional) ├── aplcart.index # FAISS embeddings index (run generate_embeddings.py to generate) ├── aplcart_metadata.pkl # Metadata for semantic search (run generate_embeddings.py to generate) ├── aplcart2json.py # Converter script ├── generate_embeddings.py # Embedding generator ├── aplcart_mcp_semantic.py # MCP server with semantic search ├── search_embeddings.py # Standalone search tool └── pyproject.toml # Project dependencies
APLCart is a searchable collection of APL idioms and expressions maintained athttps://aplcart.info/
This project is licensed under the MIT License - see theLICENSEfile for details.
Note: The APLCart data itself is subject to its ownlicensing terms.
Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.
MCP server for Christian scholarship and research — scripture, Greek/Hebrew word data, cross-references, patristic texts, and semantic search,
Access and search EPUB ebook collections using semantic vector search.
local-first semantic search in Lojban dictionaries
Search 419,000+ space regulatory filings from the FCC, ITU, UNOOSA, and FAA-AST — semantic search, entity dossiers, spectrum holdings, launch licenses, and alerts.
Self-hosted web search for AI agents — multi-engine parallel search with embedding-based result reranking. Zero API keys, pip install.
The MCP server provides end-to-end workflows for SEC filings and earnings call transcripts—including ticker resolution, document retrieval, OCR, embedding, on-disk resource discovery, and semantic search—exposed via MCP and powered by the same olmOCR and embedding backends as the vLLM backends.
MCP server that enables AI assistants to search Reddit conversations, explore subreddits, and access trending topics.
Provides semantic search across local files by creating vector embeddings from watched directories.
Embeddings, vector search, document storage, and full-text search with the open-source AI application database
Semantic search through Dickens' classic tale. Find passages by meaning, theme, or concept - not just keywords.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
