MCP TypeScript Tools Server

by Albo3

211 downloads
Not rated
GitHub

Description

# MCP TypeScript Tools Server A Model Context Protocol (MCP) server implementation in TypeScript that provides various utility tools for LLMs like Claude. This server includes calculator, datetime, and note-taking tools, with an extensible architecture for adding more tools. ##…

About

# MCP TypeScript Tools Server A Model Context Protocol (MCP) server implementation in TypeScript that provides various utility tools for LLMs like Claude. This server includes calculator, datetime, and note-taking tools, with an extensible architecture for adding more tools. ## Features - 🧮 Calculator tool for basic…

Details

Author
Albo3
Downloads
211
Categories
Other

- Basic calculator tool for mathematical operations
- Current date/time tool in short or long format
- Save, retrieve, and list text notes
- Compatible with Claude for Desktop and Cursor
- Extensible architecture for adding new tools

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP TypeScript Tools Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js v16+, clone the repo, run npm install and npm run build. Then configure the server in Claude for Desktop's claude_desktop_config.json or in Cursor's MCP settings using the command node ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js. Restart the application to access tools.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp typescript tools server": {
            "mcp-server-albo3": {
                "command": "node",
                "args": [
                    "dist/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-server-albo3": {
        "command": "node",
        "args": [
            "dist/index.js"
        ]
    }
}

MCP TypeScript Tools Server

A Model Context Protocol (MCP) server implementation in TypeScript that provides various utility tools for LLMs like Claude. This server includes calculator, datetime, and note-taking tools, with an extensible architecture for adding more tools.

Features

- 🧮 Calculator tool for basic mathematical operations
- 📅 DateTime tool for current date/time in different formats
- 📝 Notes tool for saving and retrieving text notes
- 🔌 Compatible with Claude for Desktop and Cursor
- 🚀 Easy to extend with new tools

Prerequisites

- Node.js (v16 or higher)
- npm (comes with Node.js)
- Claude for Desktop and/or Cursor (for using the tools)

Installation

1. Clone the repository:

git clone <your-repo-url>
cd MCP

2. Install dependencies:

npm install

3. Build the project:

npm run build

Setting Up with Claude for Desktop

1. Open or create your Claude desktop configuration file:
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

2. Add the MCP server configuration:

{
"mcpServers": {
"MCPllmContext": {
"command": "node",
"args": [
"ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js"
]
}
}
}

Replace ABSOLUTE_PATH_TO_YOUR_PROJECT with the actual path to your project directory.

3. Restart Claude for Desktop
4. Look for the hammer icon in the input box to confirm the tools are available

Setting Up with Cursor

1. Open Cursor
2. Go to Cursor Settings > Features > MCP
3. Click on + Add New MCP Server
4. Fill in the form:
- Type: stdio
- Name: MCPllmContext
- Command: node ABSOLUTE_PATH_TO_YOUR_PROJECT/dist/index.js

Available Tools

Calculator

- Tool name: calculate - Description: Evaluates mathematical expressions - Usage: "Calculate 2 + 2"

DateTime

- Tool name: current-date - Description: Returns current date/time - Formats: "short" or "long" - Usage: "What's today's date?"

Notes

- Tool name: save-note, get-note, list-notes - Description: Save and retrieve text notes - Usage: "Save a note titled 'Meeting' with content 'Discuss project'"

Adding New Tools

1. Create a new file in src/tools/ (e.g., src/tools/myTool.ts)
2. Implement your tool using the template:

import { z } from "zod";
import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

export function registerMyTools(server: McpServer) {
server.tool(
"tool-name",
{
param: z.string().describe("Parameter description")
},
async ({ param }) => {
return {
content: [{ type: "text", text: "Result" }]
};
}
);
}


3. Export your tool in src/tools/index.ts
4. Register your tool in src/index.ts

Development

```bash

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.