devcontext

alexcuesta/devcontext

3.1

If you are the rightful owner of devcontext and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The DevContext MCP Server is a Model Context Protocol server designed to provide file system access tools for AI assistants.

DevContext MCP Server

A Model Context Protocol (MCP) server that provides file system access tools for AI assistants.

Features

  • read_file: Read the contents of any file
  • search_files: Search for text across files (coming soon)

Setup

  1. Install dependencies:
npm install
  1. Build the TypeScript code:
npm run build

Testing with MCP Inspector

Use the official MCP Inspector to test your server:

# Run the inspector with your server
npx @modelcontextprotocol/inspector node dist/mcp-server/index.js

This will:

  1. Start your MCP server
  2. Open a web interface at http://localhost:3000
  3. Show available tools and let you test them

Example Tests

Test read_file:

{
  "path": "package.json"
}

Test search_files:

{
  "query": "devcontext",
  "extensions": [".json", ".md"]
}

Development

For development with hot reload:

# Run in watch mode
npm run dev

# Test with TypeScript directly
npx @modelcontextprotocol/inspector tsx src/mcp-server/index.ts

Available Scripts

  • npm run dev - Run with hot reload (development)
  • npm run build - Compile TypeScript to JavaScript
  • npm run start - Run the compiled server
  • npm test - Run tests (not implemented yet)

Troubleshooting

  • Build errors: Make sure TypeScript is installed (npm install -D typescript)
  • Inspector not connecting: Ensure you build first (npm run build) before running the inspector
  • File not found: Use absolute paths or paths relative to where you run the command