Advertise
MCP.so
Sign In
S

Semantic Context MCP Server

@zishengwu

Repository

Basic information

Category

Memory & Knowledge

Last updated

Transports

stdio

Author

zishengwu

Submitted by

william cris

About Semantic Context MCP Server

A Model Context Protocol (MCP) server that leverages a vector database to efficiently index and query the codebase.

#semantic-context-mcp#code-search#vector-database

Semantic Context MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "Semantic Context MCP Server": {
      "command": "fastmcp",
      "args": [
        "run",
        "your_code_base/semantic-context-mcp/vector_search/fast_mcp_server.py:mcp"
      ],
      "env": {
        "OPENAI_API_KEY": "your_api_key",
        "OPENAI_BASE_URL": "your_api_base_url",
        "OPENAI_MODEL_NAME": "your_embedding_model_name"
      }
    }
  }
}

Semantic Context MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Semantic Context MCP Server?

Semantic Context MCP Server is a Model Context Protocol (MCP) server that uses a vector database to index your codebase and perform semantic searches. It parses code into structural blocks (functions, classes), converts them to vector embeddings, and stores them locally, allowing you to find code snippets using natural language queries rather than keyword matching. The server runs in the background, automatically tracks file changes, and incrementally updates its index to keep context up-to-date.

How to use Semantic Context MCP Server?

Install by cloning the repository and setting environment variables for an OpenAI-compatible API (OPENAI_API_KEY, OPENAI_BASE_URL, OPENAI_MODEL_NAME). Configure the MCP JSON file in your IDE with the command fastmcp run pointing to the server script. The server provides three tools: full_index, status, and query. It automatically performs an initial full index and then runs periodic incremental updates every 5 minutes.

Key features of Semantic Context MCP Server

  • Incremental indexing using a Merkle Tree for efficient updates.
  • Multi-language AST parsing: Python, Java, C++, JavaScript, TypeScript, Go.
  • Semantic code search via natural language queries.
  • Background automation with periodic incremental updates every 5 minutes.
  • Local-first storage: all data kept in ~/.chromadb.

Use cases of Semantic Context MCP Server

  • Finding semantically relevant code snippets without manual keyword guessing.
  • Keeping code context automatically updated as you edit files.
  • Integrating semantic search into MCP-compatible IDEs.

Frequently asked questions

1

What dependencies are required?

Python 3.8+ and an OpenAI-compatible API for generating embeddings. You must set `OPENAI_API_KEY`, `OPENAI_BASE_URL`, and `OPENAI_MODEL_NAME`.

2

Where is the indexed data stored?

All data (vector database and index metadata) is stored locally in the user’s home directory under `~/.chromadb`.

3

How does incremental indexing work?

A Merkle Tree built from file content hashes detects changes. Only added, modified, or deleted files are re-parsed and re-indexed, making the process efficient.

4

Which languages are supported for code parsing?

AST parsing supports Python, Java, C++, JavaScript, TypeScript, and Go.

5

How often does the server update its index?

It performs a full index on startup, then runs periodic incremental updates every 5 minutes.

Comments

More Memory & Knowledge MCP servers

PLUR

plur-ai

AI agents start every session with amnesia — you re-explain the project, repeat your preferences, and correct the same mistakes over and over. PLUR gives them a memory that persists. Your agent's corrections, preference

226

Oort

Oort

Memory for AI agents that stays correct as facts change. Open source and local first: one memory for Claude Code, Codex, Cursor and your own agents.

1

Scento Perfume API (MCP server): free fragrance API, no key

Scento

Scento Perfume API is a free fragrance API and perfume notes database for developers and AI agents. Search 1,500+ perfumes and 400+ ingredients, compare scents, find similar perfumes, map scent families and build occasio

server-noonien - shared memory MCP

sequico

Shared, serverless, conflict-free memory for AI agents: a multi-machine drop-in for the MCP memory knowledge graph.

LoreKeeper RPG (lorekeeper.com)

LoreKeeper Ltd

Mess in, magic out: pour in your D&D and TTRPG notes and LoreKeeper keeps them as a private store for your world. Ask Claude or ChatGPT about it, or build a sourcebook.

Advertise