Code Declaration Lookup MCP Server

1# Code Declaration Lookup MCP Server
2 
3An MCP server that provides full text search for code declarations. Uses SQLite with FTS5 and universal ctags to index and search functions, classes, structures, enums, and other code elements. Supports all languages that ctags supports including Python, C, Go, C++, JavaScript, Rust, Java, and many others.
4 
5## Requirements
6 
7- Python 3.13
8- Universal Ctags 6.2.0
9- SQLite with FTS5 support (included in Python 3.13)
10 
11## Installation
12 
13```bash
14git clone git@github.com:osinmv/function-lookup-mcp.git
15cd function-lookup-mcp
16claude mcp add api-lookup $(pwd)/run.sh -s user
17```
18 
19## Extending the Index
20 
21Just ask your coding agent to index your header folder. The indexing process respects your project's `.gitignore` file to avoid indexing unwanted files. Alternatively, you can generate ctags files manually using universal ctags:
22 
23```bash
24ctags --output-format=json --fields=+Sf --kinds-C=+p -R -f apis/your_api.ctags /path/to/your/headers
25```
26 
27Or drop existing ctags files into the `apis/` folder and restart the MCP server to update the index.
28 
29 
30## MCP functions
31 
32**`search_declarations(name: str, offset: int = 0, limit: int = 10)`** - Search for code declarations by name
33 
34**`list_indexed_apis()`** - List all indexed API files
35 
36**`list_api_files(api_name: str, offset: int = 0, limit: int = 100)`** - List all unique file paths for a specific API
37 
38**`list_functions_by_file(file_path: str, offset: int = 0, limit: int = 100)`** - List all functions found in a specific file
39 
40**`generate_ctags(include_directory: str)`** - Generate ctags from source files and add to index
41 
42