Claude Ts Mcps

🚀 Claude TypeScript MCP Server for Software Developers

A collection of Model Context Protocol (MCP) servers designed to support software developers using large language models (LLMs) for development assistance. While many developers prefer Cline's direct VSCode integration, the high API cost can be an issue. This project addresses this problem by implementing a powerful set of MCP servers.

🚀 Quick Start

Prerequisites

• Operating System: Any modern operating system that supports Node.js (Windows, macOS, Linux).
• Node.js Version: 16.0 or higher.
• npm Version: 6.0 or higher.

Installation Steps

1. Clone this repository:

   git clone https://github.com/your-repository.git
   

2. Install dependencies:

   cd your-repository
   npm install
   

3. Start the server:

   npm start
   

✨ Features

Functionality

• Brave Search: Enables fast and privacy-friendly web searches via the Brave Search API.
• File System: Provides secure file operations, including reading, writing, and directory management.
• Git: Supports full Git version control operations, such as committing, pulling, and switching branches.
• GitHub: Integrates with the GitHub API, supporting repository management, issue tracking, and Pull Request operations.
• Shell Commands: Allows system commands to be executed in a controlled environment.
• Puppeteer: Enables browser automation for web scraping and interaction testing.
• Fetch: Supports fetching content from URLs and offers HTML to Markdown conversion.

Security

All servers have built - in strict security measures:

• File system and Shell servers restrict access permissions.
• Shell command execution is based on a whitelist mechanism, allowing only specific secure commands.
• The Fetch server adheres to the robots.txt rules by default to avoid unnecessary web scraping conflicts.

📚 Documentation

Configuration Instructions

Loading the Configuration File

1. Open Claude Desktop.
2. Import the config.json file (located in the project root directory).
3. Ensure that Claude Desktop can access the necessary environment variables.

Environment Variable Configuration

GitHub Server

The GitHub MCP server supports multi - account configuration:

"env": {
    "GITHUB_PERSONAL_TOKEN": "your-personal-token",
    "GITHUB_WORK_ACCOUNT_TOKEN": "your-work-account-token"
}

Specify the account_profile parameter in the request to select a specific account:

{
    "owner": "username",
    "repo": "repo-name",
    "path": "path/to/file.txt",
    "account_profile": "work" // Use the work account token
}

Fetch Server

Customize the Fetch behavior through environment variables:

"env": {
    "CUSTOM_USER_AGENT": "YourCustomAgent/1.0", // Custom User - Agent string
    "IGNORE_ROBOTS_TXT": "true" // Ignore the `robots.txt` rules (use with caution)
}

Usage Instructions

1. Start Claude Desktop.
2. Load the config.json file in the project root directory.
3. Start using the new tool features.

Development Guide

Each MCP server is an independent TypeScript module located in the src directory:

• src/brave-search.ts: Integration with the Brave Search API.
• src/filesystem.ts: File system operations.
• src/git.ts: Execution of Git commands.
• src/github.ts: Integration with the GitHub API (including repositories, issues, and Pull Requests).
• src/shell.ts: Controlled execution of Shell commands.
• src/puppeteer.ts: Browser automation functionality.
• src/fetch.ts: URL content retrieval and HTML to Markdown conversion.

Adding New Features

1. Create a new TypeScript file in the src directory.
2. Implement a new MCP server using @modelcontextprotocol/sdk.
3. Add the new server to the configuration file.

🔧 Technical Details

Introduction

The Claude TypeScript MCP server is a set of customized tools written in TypeScript, designed to enhance the functionality of Claude Desktop. These servers provide various useful tools, including file system operations, Git version control, GitHub integration, browser automation, and URL content retrieval, helping developers complete daily tasks more efficiently.

⚠️ Important Note

• File system and Shell servers strictly limit access permissions to prevent unauthorized operations.
• Always validate user input to avoid command injection attacks.
• Choose allowed directory paths carefully during configuration.
• Obtain GitHub tokens from trusted sources and ensure their secure storage.

📚 References

• Model Context Protocol
• MCP Server Quick Start Guide
• Anthropic Claude

📄 License

[Project license information]