JSON Database

This MCP server provides a JSON-based database with authentication, user and project management, departmental analytics, meeting scheduling, and equipment tracking. It is designed to work with Claude Desktop, enabling you to manage data and operations directly from a unified client experience.

How to use

You connect to the MCP server using a compatible MCP client. Start the server, then use the client to perform authentication, manage users, projects, departments, and meetings, and run analytics like salary insights. The Claude Desktop integration lets you run server-side MCP tasks from the Claude interface, giving you a seamless workflow for data operations and task management.

How to install

Prerequisites you need before installation are a supported Node.js runtime and npm. If you don’t have them, install Node.js from the official website, which also provides npm.

# Install dependencies
npm install

Start the server in normal mode to run in production-like conditions, or use development mode for debugging and active development.

# Run in production/normal mode
npm start

# Run in development mode
npm run dev

Claude Desktop integration

To enable Claude Desktop to manage this MCP server, add a JSON configuration that points to the local Node.js entry point. Place this in Claude Desktop’s configuration file under the mcpServers section.

{
  "mcpServers": {
    "json-database": {
      "command": "node",
      "args": ["C:\\tam\\yol\\mcp-tone\\src\\index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Usage examples

Log in to the system using a valid account, retrieve the list of users, run salary analytics, and create new tasks. You can perform these actions through the MCP client’s UI, which communicates with the server endpoints to execute the corresponding operations.

Security and default access

Passwords are hashed using bcrypt for secure storage. JWT tokens are valid for 24 hours to balance security with user convenience. It is important to change the default JWT secret in production deployments to maintain security integrity.

What the server includes

Project structure mirrors a typical MCP server: a main runtime, authentication logic, and JSON-based data access. You will find a main entry point, authentication helpers, and a simple JSON database used for initial data storage.

Directory structure

mcp-tone/
├── src/
│   ├── index.js          # Main MCP server
│   ├── auth.js           # JWT and password handling
│   └── database.js       # Database operations
├── data/
│   └── database.json     # JSON database
├── package.json
└── README.md

Default users

Admin: admin@company.com / password123, Manager: fatma@company.com / password123, Employee: ahmet@company.com / password123.

Notes on configuration and security

Configure who can access the server using the JWT-based authentication system. Review security practices regularly, rotate secrets, and monitor token usage to prevent unauthorized access.

Build and deployment notes

The server is designed to be run with Node.js. Use the provided npm scripts to install dependencies, start the server, and run in development mode as needed during development.

License

MIT license.

Available tools

JWT authentication

JWT-based login system to securely authenticate users and manage sessions.

User management

CRUD operations for users, including search capabilities.

Project management

Manage projects and track tasks within the system.

Department analytics

Statistical analysis and salary analytics across departments.

Meeting management

Plan and track meetings within the organization.

Equipment management

Assign and track devices within teams.