MCP.so
登录

CodeCompass MCP Server

@alvinveroy

基本信息

分类

AI 与智能体

许可证

MIT

传输方式

stdio

作者

alvinveroy

关于 CodeCompass MCP Server

CodeCompass: AI-powered Vibe Coding with MCP. Connects Git repositories to AI assistants like Claude, using Ollama for privacy or OpenAI for cloud. Integrates with VSCode, Cursor, and more.

CodeCompass MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "CodeCompass": {
      "command": "docker",
      "args": [
        "run",
        "-p",
        "6333:6333",
        "-p",
        "6334:6334",
        "qdrant/qdrant"
      ]
    }
  }
}

CodeCompass MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表,不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is CodeCompass?

CodeCompass helps developers tackle legacy or existing codebases by giving AI coding assistants the context they need for spot-on suggestions. It analyzes your codebase with Qdrant Vector Store and powers AI using Ollama (local) or cloud agents like DeepSeek, employing Agentic RAG to make suggestions smarter and more relevant. It is designed for developers working with messy, outdated, or poorly documented code who want to use AI-assisted development.

How to use CodeCompass?

Install prerequisites: Node.js v20+, Docker (for Qdrant), Ollama (with nomic-embed-text:v1.5 and optionally llama3.1:8b), and optionally a DeepSeek API key. Run npx -y @alvinveroy/codecompass@latest to install globally. Then start the server with codecompass [repoPath] [--port <number>] from the root of your git repository. You can also use CLI client mode to execute specific tools like agent_query, search_code, or switch_suggestion_model directly.

Key features of CodeCompass

  • Maps repository structure and dependencies with large file chunking.
  • Agentic RAG intelligently orchestrates context gathering for AI suggestions.
  • Central agent_query tool plans multi-step tasks using internal capabilities.
  • Supports local LLMs via Ollama or cloud AI like DeepSeek.
  • Extensive environment variable configuration for indexing and agent behavior.

Use cases of CodeCompass

  • Analyze a large legacy codebase to understand its structure and dependencies.
  • Get AI-powered code suggestions for modifying or extending existing code.
  • Perform semantic code search across a repository with natural language queries.
  • Switch between local and cloud AI models depending on privacy or performance needs.

常见问题

1

What are the prerequisites for running CodeCompass?

You need Node.js v20+, Docker (for Qdrant), and Ollama installed. Optionally, a DeepSeek API key is required if you want to use cloud-based suggestions.

2

How do I set up CodeCompass with a cloud AI provider?

Set the environment variable `LLM_PROVIDER` to `"deepseek"` and provide your `DEEPSEEK_API_KEY`. You can set these in your shell, a `.env` file, or through your MCP client’s configuration.

3

How can I switch the suggestion model at runtime?

Use the `switch_suggestion_model` tool with parameters like `{"model": "deepseek-coder", "provider": "deepseek"}` via the CLI client or through an MCP client that supports tool calls.

4

What is the utility HTTP server for?

The utility HTTP server (default port 3001) provides health checks, indexing status, and repository update notifications. If the port is already in use by another CodeCompass instance, the new instance disables its own HTTP server and relays requests to the existing one.

5

How do I run CodeCompass as a client to execute specific tools?

Use `codecompass <tool_name> [json_parameters] [--repo <path>] [--json] [--port <number>]`. For example, `codecompass search_code '{"query": "database connection setup"}'` performs a semantic search and returns results.

评论

AI 与智能体 分类下的更多 MCP 服务器