Skip to main content
Glama

MCP Learning

A Model Context Protocol (MCP) server that provides arithmetic tools for AI assistants like Claude.

Features

  • Add Tool: Add two numbers together with structured input/output

Related MCP server: MCP Server Deployment Demo

Installation

Prerequisites

  • Node.js 18 or higher

  • npm, yarn, or pnpm

From Git Repository

# Clone the repository
git clone https://github.com/sadjad-chrono/mcp-learning.git
cd mcp-learning

# Install dependencies
pnpm install
# or
npm install

# Build the project
pnpm build
# or
npm run build

Usage with Claude Desktop

To use this MCP server with Claude Desktop, you need to add it to your Claude configuration file.

Configuration Steps

  1. Locate your Claude Desktop config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Add the server configuration:

{
  "mcpServers": {
    "mcp-learning": {
      "command": "npx",
      "args": [
        "-y",
        "@sadjadteh-chrono/mcp-learning"
      ]
    }
  }
}

Option 2: Using the built package from cloned repo

After building the project, add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-learning": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-learning/dist/mcpserver/index.js"
      ]
    }
  }
}

Option 3: Development mode with tsx

{
  "mcpServers": {
    "mcp-learning": {
      "command": "npx",
      "args": [
        "-y",
        "tsx",
        "/absolute/path/to/mcp-learning/src/mcpserver/index.ts"
      ]
    }
  }
}
  1. Restart Claude Desktop to load the new configuration.

Verifying the Installation

Once configured and Claude Desktop is restarted:

  1. Open a new conversation in Claude

  2. Look for the šŸ”Œ icon or hammer icon indicating MCP tools are available

  3. Try using the add tool by asking Claude to "add 5 and 3"

Development

Project Structure

mcp-learning/
ā”œā”€ā”€ src/
│   └── mcpserver/
│       └── index.ts          # Main MCP server implementation
ā”œā”€ā”€ dist/                     # Compiled JavaScript (generated)
ā”œā”€ā”€ package.json
ā”œā”€ā”€ tsconfig.json
└── README.md

Available Scripts

# Build the project
pnpm build

# Run in development mode
pnpm dev

# Run in development mode with auto-reload
pnpm dev:watch

# Run with debugger
pnpm debug

# Clean build artifacts
pnpm clean

Testing with MCP Inspector

You can test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector tsx src/mcpserver/index.ts

This will open a web interface where you can interact with your MCP server and test tools.

Adding New Tools

To add new tools to your MCP server, edit src/mcpserver/index.ts:

server.registerTool(
  "tool-name",
  {
    title: "Tool Title",
    description: "What the tool does",
    inputSchema: {
      param1: z.string().describe("Description of param1"),
      // Add more parameters
    },
    outputSchema: { result: z.string() },
  },
  async ({ param1 }) => {
    // Tool implementation
    return {
      content: [{ type: "text", text: "result" }],
      structuredContent: { result: "result" },
    };
  }
);

Publishing to Git

# Initialize git repository (if not already done)
git init

# Add all files
git add .

# Create initial commit
git commit -m "Initial commit: MCP learning server"

# Add remote repository
git remote add origin https://github.com/sadjad-chrono/mcp-learning.git

# Push to GitHub
git push -u origin main

Publishing to npm

Prerequisites

  1. Create an npm account at https://www.npmjs.com/signup

  2. Login to npm: npm login

Publish Steps

# Build the package
pnpm build

# Publish to npm (scoped packages are public by default for free accounts)
npm publish --access public

Note: The --access public flag is required for scoped packages on free npm accounts.

Then users can install with:

npm install -g @sadjadteh-chrono/mcp-learning
# or use with npx
npx @sadjadteh-chrono/mcp-learning

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Install Server
A
license - permissive license
B
quality
D
maintenance

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • F
    license
    C
    quality
    D
    maintenance
    A demonstration MCP server that provides a simple addition tool for learning how to create and deploy servers following the Model-Context-Protocol specification. Serves as a basic example for developers getting started with MCP server development.
    Last updated
    1
  • F
    license
    -
    quality
    C
    maintenance
    A demonstration MCP server that exposes basic arithmetic tools (add, subtract, ping) through FastAPI and shows how to integrate them with OpenAI's tool-calling API for LLM orchestration.
    Last updated
  • F
    license
    -
    quality
    D
    maintenance
    A sample MCP server that provides basic arithmetic tools like addition, subtraction, multiplication, and division. It serves as a demonstration for implementing the Model Context Protocol and connecting custom tools to clients like Claude Desktop.
    Last updated

View all related MCP servers

Related MCP Connectors

  • Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • An MCP server that gives your AI access to the source code and docs of all public github repos

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sadjad-chrono/mcp-learning'

If you have feedback or need assistance with the MCP directory API, please join our Discord server