MCP cover image
See in Github
2025-04-04

1

Github Watches

0

Github Forks

0

Github Stars

MCP Server (Language Server Protocol)

A TypeScript-based Language Server Protocol implementation for code reference searching with support for multiple search strategies.

Features

  • 🔍 Fast code reference search using ripgrep
  • 🌐 Web interface for easy searching
  • 💻 Terminal interface for command-line usage
  • 📊 Grouped results by file type
  • 🔄 Fallback search mechanisms
  • 🔥 Hot reload support for development

Prerequisites

Before you begin, ensure you have the following installed:

  • Node.js (v14 or higher)
  • npm (comes with Node.js)
  • Homebrew (for macOS users)
  • ripgrep (recommended for faster searches)

Installation

1. Clone the Repository

git clone <your-repository-url>
cd <repository-name>/src/mcp-server/v1

2. Install Homebrew (macOS only)

# Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Add Homebrew to PATH (follow the instructions shown after installation)
# Usually these commands:
(echo; echo 'eval "$(/opt/homebrew/bin/brew shellenv)"') >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# Restart your terminal or run
source ~/.zprofile

3. Install ripgrep

# macOS (using Homebrew)
brew install ripgrep

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install ripgrep

# Fedora
sudo dnf install ripgrep

# Windows (using Chocolatey)
choco install ripgrep

4. Install Dependencies

npm install

Usage

Building the Project

npm run build

Starting the Server

Production Mode

npm run start

Development Mode (with hot reload)

npm run dev

Accessing the Interfaces

  1. Web Interface

    • Open your browser and navigate to: http://localhost:3000
    • Enter your search term and directory
    • View results grouped by file type
  2. Terminal Interface

    • The terminal interface starts automatically with the server
    • Follow the prompts to enter search terms
    • Results will be displayed in the terminal

Search Strategies

The server uses multiple search strategies in the following order:

  1. ripgrep (fastest)

    • Uses regular expressions for exact and partial matches
    • Excludes common directories (node_modules, .git, etc.)
    • Provides line numbers and context
  2. grep (fallback)

    • Used if ripgrep is not available
    • Similar functionality but slower
  3. Node.js (final fallback)

    • Pure JavaScript implementation
    • Used if neither ripgrep nor grep is available

Configuration

Environment Requirements

  • The server automatically checks for required software
  • Provides installation instructions if anything is missing
  • Verifies correct working directory

TypeScript Configuration

  • Target: ES2020
  • Module: CommonJS
  • Strict type checking enabled
  • Source maps generated for debugging

Troubleshooting

Common Issues

  1. Wrong Directory

    • Ensure you're in the src/mcp-server/v1 directory
    • Check the path shown in the environment check
  2. Homebrew Installation

    • If Homebrew commands fail, ensure PATH is configured
    • Check ~/.zprofile for Homebrew configuration
  3. ripgrep Not Found

    • Verify Homebrew is installed and in PATH
    • Try reinstalling: brew reinstall ripgrep
  4. Port Already in Use

    • The server will automatically find an available port
    • Default port is 3000

Error Messages

If you see these errors, try the following:

  1. command not found: brew

    • Reinstall Homebrew
    • Reconfigure PATH
  2. command not found: rg

    • Install ripgrep: brew install ripgrep
    • Verify PATH configuration
  3. EADDRINUSE

    • Port is in use
    • Server will automatically try another port

Development

Available Scripts

  • npm run build: Build the project
  • npm run start: Start in production mode
  • npm run dev: Start with hot reload
  • npm run clean: Clean build output

Adding New Features

  1. Modify server.ts for core functionality
  2. Update index.html for web interface changes
  3. Run in dev mode to test changes
  4. Build and restart to apply

相关推荐

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • https://zenepic.net
  • Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.

  • Lists Tailwind CSS classes in monospaced font

  • apappascs
  • Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.

  • ShrimpingIt
  • Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx

  • modelcontextprotocol
  • Model Context Protocol Servers

  • Mintplex-Labs
  • The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.

  • ravitemer
  • A powerful Neovim plugin for managing MCP (Model Context Protocol) servers

  • jae-jae
  • MCP server for fetch web page content using Playwright headless browser.

  • patruff
  • Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools

  • n8n-io
  • Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

  • pontusab
  • The Cursor & Windsurf community, find rules and MCPs

    Reviews

    5 (1)
    Avatar
    user_vf3EoJmw
    2025-04-17

    I am thoroughly impressed with mcp-server. Created by the talented Meeneshsolanki, this tool is an indispensable addition to my software stack. Its robust functionality and ease of use streamline my server management like never before. The clear documentation and active community support make it even better. Highly recommended to anyone in need of a reliable server solution!