Skip to main content
Glama
MCP Sample Server

MCP Sample Server

MCP Sample Server

シンプルなModel Context Protocol (MCP)サーバーのサンプル実装です。

関連プロジェクト

  • MCPクライアント: このサーバーと対話するための自然言語クライアント

    • OpenAI APIを使用して自然言語でMCPツールを実行

    • GitHubリポジトリ: yukinaka/mcp-client

    • ローカルパス: ../mcp-client/

Related MCP server: Calculator MCP

機能

このMCPサーバーは以下の機能を提供します:

ツール

  1. get_current_time - 現在の時刻を取得

    • パラメータ: timezone (オプション) - タイムゾーン(例: Asia/Tokyo, UTC)

  2. calculate - 簡単な計算を実行

    • パラメータ:

      • operation - 演算の種類(add, subtract, multiply, divide)

      • a - 最初の数値

      • b - 2番目の数値

リソース

  • サンプルノートへのアクセス(note:///welcome, note:///example)

インストール

前提条件

  • Node.js (v18以上)

  • npm または yarn

ローカル開発

# リポジトリをクローン
git clone https://github.com/yukinaka/mcp-sample-server.git
cd mcp-sample-server

# 依存関係をインストール
npm install

# ビルド
npm run build

npmパッケージとしてインストール(公開後)

npm install -g @odenalexbs/mcp-sample-server

使い方

MCPクライアントで使用する(推奨)

このサーバーには、OpenAI APIを使用した自然言語クライアントが付属しています。

cd ../mcp-client
npm install
npm start

詳細はmcp-client/README.mdを参照してください。

Claude Codeで使用する

.claude/settings.local.json に以下の設定を追加します:

開発版(ローカル)を使用する場合

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

GitHubから直接使用する場合

{
  "mcpServers": {
    "sample": {
      "command": "npx",
      "args": ["-y", "github:yukinaka/mcp-sample-server"]
    }
  }
}

npmパッケージとして使用する場合(公開後)

{
  "mcpServers": {
    "sample": {
      "command": "npx",
      "args": ["-y", "@odenalexbs/mcp-sample-server"]
    }
  }
}

他のMCPクライアントで使用する

Claude Desktop等の他のMCPクライアントでも同様に設定できます。クライアントの設定ファイルに上記のような設定を追加してください。

開発

ウォッチモード

npm run watch

テスト実行

# サーバーを直接実行してテスト
npm run build
npm start

GitHub公開手順

  1. GitHubで新しいリポジトリを作成

  2. ローカルでGitリポジトリを初期化:

git init
git add .
git commit -m "Initial commit: MCP sample server"
git branch -M main
git remote add origin https://github.com/yukinaka/mcp-sample-server.git
git push -u origin main
  1. (オプション)npmに公開:

npm login
npm publish

カスタマイズ

このサンプルをベースに、独自のツールやリソースを追加できます:

  • src/index.ts の tools 配列に新しいツールを追加

  • CallToolRequestSchema ハンドラーに実装を追加

  • リソースを追加する場合は resources 関連のハンドラーを修正

ライセンス

MIT

参考リンク

Available Tools

2 tools
calculateC

簡単な計算を実行します(加算、減算、乗算、除算)

Inputs: operation (required), a (required), b (required).

get_current_timeB

現在の時刻を取得します

Inputs: timezone.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: 'calculate' handles mathematical operations, while 'get_current_time' retrieves temporal information. There is no overlap in functionality, making it impossible for an agent to confuse them.

    Naming Consistency3/5

    The naming is mixed: 'calculate' uses a verb-only style, while 'get_current_time' follows a verb_noun pattern. Although both are readable, they lack a consistent convention, which could lead to minor confusion in a larger set.

    Tool Count2/5

    With only 2 tools, this server feels thin and under-scoped for a general-purpose 'MCP Sample Server'. It lacks coverage for common operations beyond basic math and time, suggesting it might be a minimal example rather than a fully functional server.

    Completeness2/5

    Given the server's name implies a sample or general utility scope, the toolset is severely incomplete. It misses obvious utilities like string manipulation, file operations, or data conversion, leaving significant gaps that would hinder agent workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol server that provides basic calculator functionality for LLMs, enabling them to perform mathematical operations like addition, subtraction, multiplication, division, modulo, and square root.
      6
      235 npm
      15
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      A simple server that provides basic mathematical operations (sum and subtraction) through the Model Context Protocol.
      2
      1
      -
    • A
      license
      B
      quality
      D
      maintenance
      A Model Context Protocol server implementation that provides basic utility tools including echo, uppercase text conversion, and mathematical calculations.
      3
      MIT