mcpField
V
very-simple-mcp-server-sample

very-simple-mcp-server-sample

Local
github.com/ynaotoDeveloper Tools0Updated 81w ago
Repository

About very-simple-mcp-server-sample

A sub-50-line Node.js sample that demonstrates building and configuring a basic MCP server. It is intended for developers learning MCP server setup, with a short build process and a Claude Desktop configuration example.

Key features

  1. 01Fewer than 50 lines of code
  2. 02Builds with npm install and npm run build
  3. 03Includes Claude Desktop configuration example

Use cases

  1. 01Learning the basic MCP server setup flow
  2. 02Testing a server in Claude Desktop

MCP support

This sample implements an MCP server. It can be configured in Claude Desktop and presents its available MCP tools there.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

very-simple-mcp-server-sample

(English follows)

おそらくは、世界で最もシンプルな MCP サーバーのサンプルです。コードは50行もありません。

以下の手順でビルドしてください。（node と npm はご自身でインストールしてください。node を入れると npm も入ります）

npm install

npm run build

上記が完了し、build フォルダができていれば成功です。このフォルダへのパスを <PATH_TO_HERE> とし、 例えば、Claude Desktop であれば、以下を claude_desktop_config.json に記述してください。（mcpServers の中に追加記述です）

{
  "mcpServers": {
    "very-simple-mcp-server-sample": {
      "command": "node",
      "args": [
        "<PATH_TO_HERE>/build/index.js"
      ]
    }
  }
}

「利用可能なMCPツール」

README image

で、以下のように表示されれば設定完了です。

README image

Claude Desktop で「1,2,3をごにょごにょしてください」などと頼むと、以下のようになりますので許可してください。

README image

以下のようになれば成功です。

README image

(Japanse above)

This is probably the simplest MCP server sample in the world. The code is less than 50 lines.

Please build it using the following steps. (You need to install Node.js and npm on your own. Installing Node.js will also install npm.)

npm install

npm run build

If the above steps complete successfully and a build folder is created, you’re good to go. Assume the path to this folder is <PATH_TO_HERE>. For example, in Claude Desktop, add the following to your claude_desktop_config.json (as an entry inside mcpServers):

{
  "mcpServers": {
    "very-simple-mcp-server-sample": {
      "command": "node",
      "args": [
        "<PATH_TO_HERE>/build/index.js"
      ]
    }
  }
}

If it appears in “Available MCP Tools”

README image

like this:

README image

then the setup is complete.

When you ask Claude Desktop something like “Please do 1, 2, 3”, you’ll see a permission prompt like this—please allow it:

README image

If you see something like this, it’s working:

README image

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.