Content
# Atlas MCP Server PoC
- Uses the official MCP SDK https://github.com/modelcontextprotocol/typescript-sdk
## Table of Contents
- [Setting up your environment](#setting-up-your-environment)
- [Running the MCP Server](#running-the-mcp-server)
- [Troubleshooting (Via VSCode Insiders)](#troubleshooting-via-vscode-insiders)
- [Restart server](#restart-server)
- [Logs](#logs)
- [Supported tools](#supported-tools)
- [VSCode](#vscode)
- [Claude](#claude)
## Setting up your environment
```shell
npm install
```
## Running the MCP Server
```shell
npm run build
```
## Troubleshooting (Via VSCode Insiders)
### Restart server
- Run `npm run build` to re-build the server if you made changes to the code
- Press `Cmd + Shift + P` and type List MCP Servers
- Select the MCP server you want to restart
- Select the option to restart the server
### Logs
To see MCP logs, check https://code.visualstudio.com/docs/copilot/chat/mcp-servers.
- Press `Cmd + Shift + P` and type List MCP Servers
- Select the MCP server you want to see logs for
- Select the option to view logs in the output panel
### Debugging
We can use @modelcontextprotocol/inspector to debug the server - https://github.com/modelcontextprotocol/inspector
From the root of this repository, run:
```shell
npx @modelcontextprotocol/inspector dist/index.js
```
## Supported tools
### VSCode
Prerequisites:
- Use VSCode Insiders (https://code.visualstudio.com/insiders/)
- Setup copilot in VSCode Insiders
Step 1: Add the mcp server to VSCode configuration
- Press `Cmd + Shift + P` and type `MCP: Add MCP Server` and select it.
- Select the first option for a local MCP server.
- Add the path to dist/index.js in the prompt
Step 2: Verify the created mcp file
It should look like this
```shell
{
"servers": {
"demo-atlas-server": {
"type": "stdio",
"command": "/Users/<user>/workplace/atlas-mcp-server/dist/index.js",
"args": []
}
}
}
```
Step 3: Open the copilot chat and check that the toolbox icon is visible and has the mcp server listed.
Step 4: Try running a command
- Can you list my clusters?
### Claude
Step 1: Install claude and login
```shell
brew install claude
```
Step 2: Create a configuration file for your MCP server
Open the file
```
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
Paste the mcp server configuration into the file
```
{
"mcpServers": {
"Demo": {
"command": "path/to/this/repo/atlas-mc-server/dist/index.js"
}
}
}
```
Step 3: Launch Claude Desktop and click on the hammer icon, the Demo MCP server should be detected. Type in the chat "show me a demo of MCP" and allow the tool to get access.
- Detailed instructions with screenshots can be found in this [document](https://docs.google.com/document/d/1_C8QBMZ5rwImV_9v4G96661OqcBk1n1SfEgKyNalv9c/edit?tab=t.2hhewstzj7ck#bookmark=id.nktw0lg0fn7t).
Note: If you make changes to your MCP server code, rebuild the project with `npm run build` and restart the server and Claude Desktop.
Connection Info
You Might Also Like
MarkItDown MCP
Python tool for converting files and office documents to Markdown.
Sequential Thinking
Model Context Protocol Servers
Context 7
Context7 MCP Server -- Up-to-date code documentation for LLMs and AI code editors
claude-code-mcp
Claude Code as one-shot MCP server to have an agent in your agent.
slack-mcp-server
The most powerful MCP Slack Server with no permission requirements, Apps...
fetcher-mcp
MCP server for fetch web page content using Playwright headless browser.