Particles — MCP-сервер для Claude Code: функции и установка
Particles хранит утверждения с источниками, датами и оценкой уверенности, чтобы агент мог ссылаться на записи и отвечать с учётом их истории. Подключите его, если хотите проверять, на чём основаны ответы.
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env DATABASE_URL=<DATABASE_URL> --env PARTICLES_CONFIG=<PARTICLES_CONFIG> --transport stdio particles -- uvx linkedparticlesЧто делает Particles
Particles записывает каждое утверждение отдельно: сохраняет источник, дату, уверенность и связь с исходными данными. Записи не перезаписываются; их можно отозвать, оспорить или заменить более новой. MCP-сервер работает в режиме чтения, поэтому для заполнения хранилища используйте движок и его команды, например particles deposit и particles extract.
На вопрос сервер возвращает ответ со ссылками на утверждения, на которых он основан. Историю можно запросить на конкретный момент с помощью --as-of. Для извлечения утверждений и подготовки текстовых ответов нужна языковая модель; в примере настройки используется ANTHROPIC_API_KEY, также поддерживаются совместимые с OpenAI API. Нужен Python 3.11 или новее.
Какие задачи решает
- сохранять утверждения вместе с источниками и датами
- проверять, на каких записях основан ответ агента
- смотреть, во что верило хранилище на заданную дату
- находить противоречия и устаревшие записи командой
particles lint
Примеры запросов агенту
- Ответь на вопрос, опираясь на утверждения в хранилище, и укажи источники.
- Проверь, что хранилище считало верным на дату
2000-01-01. - Найди противоречивые и устаревшие утверждения в хранилище.
Как установить Particles
Командой платформы
claude mcp add --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env DATABASE_URL=<DATABASE_URL> --env PARTICLES_CONFIG=<PARTICLES_CONFIG> --transport stdio particles -- uvx linkedparticlesВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from linkedparticles <команда>
Командой платформы
codex mcp add particles --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --env DATABASE_URL=<DATABASE_URL> --env PARTICLES_CONFIG=<PARTICLES_CONFIG> -- uvx linkedparticlesВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from linkedparticles <команда>
Файл настроек
{
"mcpServers": {
"particles": {
"command": "uvx",
"args": [
"linkedparticles"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"DATABASE_URL": "<DATABASE_URL>",
"PARTICLES_CONFIG": "<PARTICLES_CONFIG>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from linkedparticles <команда>
Файл настроек
{
"servers": {
"particles": {
"type": "stdio",
"command": "uvx",
"args": [
"linkedparticles"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>",
"DATABASE_URL": "<DATABASE_URL>",
"PARTICLES_CONFIG": "<PARTICLES_CONFIG>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from linkedparticles <команда>
Командой платформы
gemini mcp add -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -e DATABASE_URL=<DATABASE_URL> -e PARTICLES_CONFIG=<PARTICLES_CONFIG> particles uvx linkedparticlesВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from linkedparticles <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Particles
Как установить Particles в Claude Code?
Выполните claude mcp add particles -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx linkedparticles. Для этого способа передайте ключ ANTHROPIC_API_KEY.
Что делает Particles?
Сервер предоставляет агенту доступ на чтение к хранилищу утверждений с источниками, датами и оценкой уверенности. Ответы могут ссылаться на записи, на которых основаны.
Нужен ли API-ключ для работы Particles?
Извлечение утверждений и создание текстовых ответов обращаются к языковой модели. В примере используется ANTHROPIC_API_KEY; также подходят совместимые с OpenAI API конечные точки.
