claudegoodies
CLAUDE.md

servers CLAUDE.md

From modelcontextprotocol

This file provides guidance to Claude Code when working with code in this repository.

Documents build, test, and style conventions for the official MCP reference server monorepo (4 TS + 3 Python packages).

Use it when

  • Contributing bug fixes or MCP feature demos to the official MCP servers repo
  • Building/testing one of the 7 reference servers (everything, filesystem, memory, sequentialthinking, fetch, git, time)
  • Setting up CI-consistent workflows using npm workspaces or uv/pyright/ruff
  • Checking naming, tool-annotation, or transport conventions before opening a PR

Skip it if

  • Not working inside the modelcontextprotocol/servers repo itself
  • Want to add a brand-new server implementation (redirected to the MCP Server Registry)
  • Just want README/server-listing changes (explicitly not accepted)

Facts

Repository
modelcontextprotocol/servers
Status
Actively maintained
Last commit
Source file
CLAUDE.md

Source preview

The instructions Claude Code reads when this claude.md runs.

# CLAUDE.md

This file provides guidance to Claude Code when working with code in this repository.

## Project Overview

Official MCP reference server implementations. This is an npm workspaces monorepo containing 7 servers (4 TypeScript, 3 Python) under `src/`. Each server is a standalone package published to npm or PyPI.

## Monorepo Structure

```
src/
  everything/          TS  @modelcontextprotocol/server-everything    (reference server, all MCP features)
  filesystem/          TS  @modelcontextprotocol/server-filesystem    (file operations with Roots access control)
  memory/              TS  @modelcontextprotocol/server-memory        (knowledge graph persistence)
  sequentialthinking/  TS  @modelcontextprotocol/server-sequential-thinking  (step-by-step reasoning)
  fetch/               Py  mcp-server-fetch                           (web content fetching)
  git/                 Py  mcp-server-git                             (git repository operations)
  time/                Py  mcp-server-time                            (timezone queries and conversion)
```

## Build & Test Commands

### TypeScript servers

```bash
# Single server
cd src/<server> && npm ci && npm run build && npm test

# All TS servers from root
npm install && npm run build
```

- Build: `tsc` (target ES2022, module Node16, strict mode)
- Tests: **vitest** with `@vitest/coverage-v8` (required for new test
View full source on GitHub →

Other claude.md files