Self-Aware MCP Server

MCP (Model Context Protocol) сервер, предоставляющий инструменты получения базовой информации (самосознания) для LLM - текущее время, место, ОС, математические вычисления.

TLDR (Быстрый старт)

Установка

npm install -g @vugu/self-aware-mcp-server

Настройка (Claude Code и т.п.)

в файле конфигурации mcp-серверов:

{
  "mcpServers": {
    "self-aware": {
      "command": "npx",
      "args": [
        "-y",
        "@vugu/self-aware-mcp-server",
        "Moscow, Russia"
      ]
    }
  }
}

Замените Moscow, Russia на ваше местоположение.

---

Доступные версии

Язык	Папка
TypeScript/Node.js	self-aware/
Python	self-aware-python/
C#	self-aware-csharp/

---

Доступные инструменты

1. get_current_location

Возвращает местоположение, переданное как аргумент командной строки.

2. get_current_date_time

Возвращает текущую дату и время: weekday, year-month-day hours:minutes:seconds

3. get_current_system

Возвращает информацию об ОС:

{
  "os": {
    "name": "Linux",
    "version": "6.1.0-generic",
    "displayName": "Ubuntu 22.04.3 LTS",
    "platform": "linux",
    "cpu": "x64"
  }
}

4. calculate

Безопасный калькулятор математических выражений с поддержкой:

• Тригонометрических функций (радианы)
• Гиперболических функций
• Логарифмических функций
• Статистических функций (mean, median, stdev, variance, etc.)
• Математических констант (pi, e, tau, inf, nan)

---

Использование с Claude Desktop

Добавьте в claude_desktop_config.json:

TypeScript/Node.js версия

{
  "mcpServers": {
    "self-aware": {
      "command": "node",
      "args": [
        "/path/to/self-aware/dist/index.js",
        "Moscow, Russia"
      ]
    }
  }
}

Python версия

{
  "mcpServers": {
    "self-aware": {
      "command": "python",
      "args": [
        "/path/to/self-aware-python/src/self_aware/server.py",
        "Moscow, Russia"
      ]
    }
  }
}

C# версия

{
  "mcpServers": {
    "self-aware": {
      "command": "dotnet",
      "args": [
        "/path/to/self-aware-csharp/bin/Release/net8.0/self-aware-mcp.dll",
        "Moscow, Russia"
      ]
    }
  }
}

---

Быстрый старт

TypeScript

cd self-aware
bun install
bun run build
node dist/index.js "Moscow, Russia"

Python

cd self-aware-python
pip install mcp
python src/self_aware/server.py "Moscow, Russia"

C#

cd self-aware-csharp
dotnet build -c Release
dotnet bin/Release/net8.0/self-aware-mcp.dll "Moscow, Russia"

Структура проекта

mcp-servers/
├── README.md                    # Общий README
│
├── self-aware/                  # TypeScript/Node.js версия
│   ├── package.json
│   ├── tsconfig.json
│   ├── src/
│   │   └── index.ts
│   ├── dist/
│   │   └── index.js
│   └── README.md
│
├── self-aware-python/           # Python версия
│   ├── pyproject.toml
│   ├── requirements.txt
│   ├── src/
│   │   └── self_aware/
│   │       ├── __init__.py
│   │       └── server.py
│   ├── test_server.py
│   └── README.md
│
└── self-aware-csharp/           # C# версия
    ├── self-aware-mcp.csproj
    ├── Program.cs
    └── README.md

License

MIT License

---

Author

Alexander Kazantsev