MCP Server for TypeScript SDK Context

by DotNaos

295 downloads Not rated yet

About

# MCP Server for TypeScript SDK Context This project implements a Model Context Protocol (MCP) server designed to provide context about the `modelcontextprotocol/typescript-sdk` repository and its documentation. ## Features * **Fetches File Content:** Retrieves the content of specific files directly from the…

Explore

Fetches File Content: Retrieves the content of specific files directly from the modelcontextprotocol/typescript-sdk GitHub repository (latest version on the default branch).
Searches Repository: Allows searching for code within the modelcontextprotocol/typescript-sdk repository using the GitHub API.

  • Searches Documentation (Placeholder): Includes a placeholder for searching the official modelcontextprotocol.io documentation website (requires integration with an external search tool like Bing Search).

1. Install Dependencies:

    npm install

2. Configure Environment:
Create a .env file in the project root.
Add your GitHub Personal Access Token:
        GITHUB_TOKEN=YOUR_GITHUB_TOKEN_HERE

(Ensure the token has permissions to read public repositories)
3. Build the Server:
    npm run build

Directly:

    npm start

Via MCP Client (e.g., VS Code):
Configure your MCP client to use the settings in .vscode/mcp.json. This typically involves specifying the server name (typescript-sdk-context) and the launch command (node dist/index.js).

This project implements a Model Context Protocol (MCP) server designed to provide context about the modelcontextprotocol/typescript-sdk repository and its documentation.

Features

Fetches File Content: Retrieves the content of specific files directly from the modelcontextprotocol/typescript-sdk GitHub repository (latest version on the default branch).
Searches Repository: Allows searching for code within the modelcontextprotocol/typescript-sdk repository using the GitHub API.
Searches Documentation (Placeholder): Includes a placeholder for searching the official modelcontextprotocol.io documentation website (requires integration with an external search tool like Bing Search).

Setup

1. Install Dependencies:

    npm install

2. Configure Environment:
Create a .env file in the project root.
Add your GitHub Personal Access Token:
        GITHUB_TOKEN=YOUR_GITHUB_TOKEN_HERE

(Ensure the token has permissions to read public repositories)
3. Build the Server:
    npm run build

Running the Server

Directly:

    npm start

  • Via MCP Client (e.g., VS Code):

Configure your MCP client to use the settings in .vscode/mcp.json. This typically involves specifying the server name (typescript-sdk-context) and the launch command (node dist/index.js).

How it Works

The server listens for MCP requests over standard input/output (stdio). When a client requests a tool execution:

1. The server identifies the requested tool (getGithubFileContent, searchGithubRepo, searchDocumentationWebsite).
2. It uses the @octokit/rest library (authenticated with your GITHUB_TOKEN) to interact with the GitHub API for file fetching and code search.
3. For website search, it currently returns a placeholder message (integration with a search API like Bing is needed for full functionality).
4. The results are formatted as MCP content and sent back to the client.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.