Сервер MCP Neo4j з’ўязаны з ChatGPT

У гэтым карыце практычным напамінанні паказваецца весь шлях ад сыр'ёў да рабочай сістэмы для: «Як стварыць і пад'яжыць сервер MCP Neo4j да ChatGPT». Акцэнт ставіцца на крокі, якія можна выконваць, чыстае перакананне ў правільнасці крокаў, а таксама на код, які можна проста падставіць у рэпазітарый без неабязковасці з'ясоўвання меты. Для загальнага адгледжэння, перш чым зменяць код, неабходна візначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння. Аперацыёныя працавікі должны магчымае перадзваніць крок з вядомай точкі контролю, не падозруючы пра схованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выконваецца, прычына неудачы должна вказываць на адзін конкрэтны элемент, а не на заплутаны ланцюг задач.

Введэнне

Для пачатку, перад тым як зменіць код, неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не прабуючы спадарожваць схованы стан. Спрэчывайце гэты этап як даговор межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, узначыце перакананні на успех і адмовіцеся ад беззвучнага частковага завершэння. Ўжывайце обмежэнні і індэксы перад масовым запрашэнням даных. Унікальнасць у бізнес-клучах ператварае пазнейшыя з’еднання на прагнозавальныя операцыі дапраўкі/адчысцэння, а не на сітуацыю дуплікацый.

Рэпазітарый Neo4j Labs проты офіцыйнага сервера MCP Neo4j

Для супараўнення рэпазітарыя Neo4j Labs з афіцыйным серверам MCP Neo4j неабходна прадзефінаваць вхідныя даны, абоўязкі віконавца крока і крытэрыя завершэння пры змены коду. Віконавцы должны магчымае перзапускаты крок з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Запісваюцься час выканання і выкладкі токеноў або запытак праза функцыйнае рэзультат. Відразлівае прадставлення выкладак у раннім этапе запобегае неспадзяваным рахункам, калі працэс пераходзіць з дэмовых срэдаванняў у спадзеленыя. Перш чым адбываецца масовая загрузка, неабходна выкорыстоўваць обмежэння і індэксы. Унікальнасць ключоў дадзенняях ператварае пазнейшыя злучэння на прагнозаваныя аператыўныя дзеянні заместа стварэння дуплікатаў.

Архітэктура

Для архітэктуры, перш чым зменяць код, неабходна ясная ваказка пра вхідныя даны, адпаведальнага за крок і крытэрыя завершэння. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозруючы пра схованы стан. Конфігурацыю трэба знаходзіць за межамі коду прыкладнення. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцыйяў должны быць аднароджаны ў аднам месца, куда аператары можуць адбавіць аўдыт, не чытаючы весь ланцуг апрацоўкі. Перш чым запускаць масовую інтэграцыю, трэба выкарыстоўваць обмежэння і індэксы. Унікальнасць бізнес-ключоў ператварае пазнейшыя з’еднання на прагнозаваныя аператыўныя дзеяння, а не на сітуацію з дуплікатамі. Для архітэктуры, перш чым зменяць код, неабходна ясная ваказка пра вхідныя даны, адпаведальнага за крок і крытэрыя завершэння. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозруючы пра схованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцуг апрацоўкі.

Пярэхутныя умовы

Для пярэхутных умоў неабходна перад зменай коду задаць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння. Аперацыяныя працавнікі должны магчымае перадзеўваць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Спрыяйце цім этапу як кантракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даць назвы артыфактам, задаць перакананні ў успеху і не прабаваць прыймаць часткова завершаны рэзультаты без падтверджэння. Пасля першага пакета даных неабходна адразу пераглянуць прыкладны раён. Засобы тыпу Cypher дапамагаюць выявіць змены ў меткаванні і відсутнасць атрыбутаў дышэльней, чым тэсты на весь цікл.

Крок 1: Пераканацца ў архітэктуры Ubuntu

Для першага: пераканацеце архітэктуру Ubuntu, задайце параметры вводу, адміністратара шагу і крэтыяры завершэння пры зміне коду. Аператары должны магчымаць перзапуск шагу з вядомай точкі контролю без неабясненняя схованага стану. Запісвайце час выканання і кост токена або запыту праз функцыйнальныя рэзултаты. Відразлівасць коста з самага пачатку запобегае неспакоўным рахункам, калі парадок зменяецца з дэмавай версіі на спадзеленыя сераўры.

Шаг 2: Установіце афіцыйны сервер MCP Neo4j

Для 2-го крока: падзейце Афіцыйны сервер MCP Neo4j, задаць параметры вводу, адпаведнага адпаведальніка за крок і крэтыяры завершэння пры перадзеіснавленні коду. Аператары должны магчымаць перапрыявленне крока з вядомай точкі контролю без неабясненняя схованага стану. Канфігурацыю трэба залічыць пазначанай ад коду прыкладнення. Файлы сераўіса, сховішчы секрэтных даных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без чытання всіх дадзеных. Працаваць з прыкладам суседства пасля першага пакета. Тэсты на адпаведнасць Cypher выяўляюць змены атрыбутаў і відсутнае значэнняя атрыбутаў дышча, чым тэсты на весь ланцоўку. Для 2-го крока: падключыце Афіцыйны сервер MCP Neo4j, задаць параметры вводу, адпаведнага адпаведальніка за крок і крэтыяры завершэння пры перадзеіснавленні коду. Аператары должны магчымаць перапрыявленне крока з вядомай точкі контролю без неабясненняя схованага стану. Валіць маленькія, тэставальныя елементы замест большых скрыптов. Калі крок не выйшаў, прычына неудачы должна быць вказаная як адзін конкрэтны элемент.

Адміністрацыя заместо заплутанага ланцуга працэй.

tar -xzf neo4j-mcp_Linux_x86_64.tar.gz
chmod +x neo4j-mcp
sudo mv neo4j-mcp /usr/local/bin/neo4j-mcp

neo4j-mcp --help

python3 -m venv neo4j-mcp-venv
source neo4j-mcp-venv/bin/activate
pip install neo4j-mcp-server

Шаг 3: З’ясаваць наявныя інструменты MCP

Для шага 3: З’ясаваць наявныя інструменты MCP неабходна ўскладніць вхідныя даны, адпаведальную особу за шаг і крытэрыі завершэння перш чым змяніць код. Аператары должны магчымае перадзваніць шаг з вядомай точкі контролю без неабясненняя схованага стану. Спрыятлівае ставленне да гэтага этапу як да кантракту межа вхіднымі данымі і пасвярджанымі выходнымі рэзультатамі. Назваце элементы, ускладніць перакананняя пра успех і адмовіцеся ад беззвучнага частковага завершэння. Створыце мадэлі вузлаў і зв’язкаў для запытанняў, якія вы будзеце ставіць, а не для кожнага іменніка ў дакумэнце. Разрозненыя, тыпаваныя канектары лепшыя за ўжоўткнутыя, загадковыя графы.

Шаг 4: Створыць абмежанага карыстальніка Neo4j

Для 4-го крока: створыце адміністратара Neo4j з обмежанымі правамі, задайце параметры вводу, адказчыка крока і крытэрыя завершэння пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан. Запісвайце час выканання і вартасьць токена або запытку праз адзін з рэзультатаў функцыянальнасці. Візуабілізація вартасцей з самага пачатку запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную. Складзіце модэлі вузлаў і звязаў для запытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Рыхлыя, тыпаваныя рэбры лепшыя за ўжоўтучныя, загадочныя графы.

cypher-shell \
  -a bolt://127.0.0.1:7687 \
  -u mcp_reader \
  -p 'YOUR_PASSWORD' \
  'MATCH (n) RETURN count(n) AS node_count;'

5-й крок: налаштаваць Neo4j MCP у рэжыме STDIO

Для 5-го крока: налаштаваючы Neo4j MCP у рэжыме STDIO, паказвайце вхідныя даны, адміністратара крока і крытэрыя завершэння пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здогадацца пра схованы стан. Канфігурацыю трэба залічыць паза кодам прыкладнення. Файлы сераўіса, хранільнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядзець, не чытаючы весь граф. Стварайце вузлы і зв’язкі для запітанняў, якія вы будзеце ставіць, а не для кожнага іменніка ў дакуменце. Рэдкія, тыпаваныя рэбры лепшыя за ўжоўтучныя, загадковыя графы. Для 5-го крока: налаштаваючы Neo4j MCP у рэжыме STDIO, паказвайце вхідныя даны, адміністратара крока і крытэрыя завершэння пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здагадацца пра схованы стан. Валічыце маленькія, тэставальныя елементы працоўнікамі над велікімі скрыптамі. Калі крок не выйшоў, прычына неудачы должна вказываць на аднаго адпаведальнага.

заместо заплутанай лінійкі.

export NEO4J_URI="bolt://127.0.0.1:7687"
export NEO4J_USERNAME="mcp_reader"
export NEO4J_PASSWORD="YOUR_NEO4J_PASSWORD"
export NEO4J_DATABASE="neo4j"
export NEO4J_READ_ONLY="true"
export NEO4J_TRANSPORT_MODE="stdio"
export NEO4J_LOG_LEVEL="info"
export NEO4J_LOG_FORMAT="text"

neo4j-mcp

Шаг 6: З’ясаванне альтэрнатывы HTTP

Для шага 6: З’ясаванне альтэрнатывы HTTP неабходна дэфініцыя вхідных даных, адміністратара шагу і крэтэрыяў завершэння пры зміне коду. Аператары должны магчыма было перзапускаць шаг з вядомай точкі контролю, не спрабоўваючы здогадвацца пра схованы стан. Спрыяйце цім этапу як кантракту межа вхіднымі данымі і падтвердзенымі выходнымі данымі. Дайце назву артыфактам, дэфініруйце пераканальвання успеху і адмовіцеся ад бяспечнага частковага завершэння. Ўжыце обмежэнні і індэксы пры масовай абрабоце. Унікальнасць па бізнес-клучох прыводзіць да таго, што пазнейшыя з’еднання стаюць прыведамымі апдэйтамі, а не бурамі дуплікатаў.

export NEO4J_URI="bolt://127.0.0.1:7687"
export NEO4J_DATABASE="neo4j"
export NEO4J_READ_ONLY="true"
export NEO4J_TRANSPORT_MODE="http"
export NEO4J_MCP_HTTP_HOST="127.0.0.1"
export NEO4J_MCP_HTTP_PORT="8000"

unset NEO4J_USERNAME
unset NEO4J_PASSWORD

neo4j-mcp

Authorization: Basic BASE64_ENCODED_USERNAME_AND_PASSWORD

echo -n "mcp_reader:YOUR_PASSWORD" | base64

Authorization: Bearer YOUR_OAUTH_ACCESS_TOKEN

Шаг 7: Інсталляванне OpenAI tunnel-client на Ubuntu

Для 7-го крока: установіце OpenAI tunnel-client на Ubuntu, задаце параметры вводу, адміністратара крока і крытэрыя завершэння пры зміне коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю без неабясненняя схованага стану. Запісвайце час выканання і вартась токеноў або запытак праза функцыйнальныя рэзултаты. Відразлівась вартасей з самага пачатку запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную. Ўжывайце обмежэнняі і індэксы пры масовай абрабоце. Унікальнасьць на ключах бізнесу ператварае пазнейшыя злучэння на прагнозаваныя дадзеныя, а не на сітуацію з дуплікатамі.

tunnel-client-<version>-linux-amd64.zip

tunnel-client-<version>-linux-arm64.zip

unzip tunnel-client-<version>-linux-amd64.zip
chmod +x tunnel-client
sudo mv tunnel-client /usr/local/bin/tunnel-client

tunnel-client --version
tunnel-client help quickstart

8-й крок: Стварэнне захішчанага тунелю MCP

Для крока 8: стварэння захішчанага тунелю MCP, неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння пры зміне коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю без неабяжнага адгадвання схованага стану. Конфігурацыю трэба залічыць пазнаходзяцца за межамі коду прыкладнення. Файлы сераўнавання, хранільнікі секрэтных дадзеных і флагі функцый належыць у аднам месца, якое аператары можаць пераглядаць без неабяжнага чытання всіх элементаў сістэмы. Перад масовым запоўненням дадзеных трэба выкарыстоўваць обмежэння і індэксы. Унікальнасць ключоў дадзеных ператварае пазнейшыя з’еднання на прагнозаваныя дзеянні з адночасным запісам і выкарыстоўванням, а не на стварэнне дуплікатаў. Для крока 8: стварэння захішчанага тунелю MCP, неабяжна ўзначыць вхідныя даны, адпаведальнага за крок і крытэрыя завершэння пры зміне коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю без неабяжнага адгадвання схованага стану. Валіць крашчэ маленькія, тэставаныя елементы над велікімі скрыптамі. Калі крок не выйшоў, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць.

заместо заплутанай лінійкі працы.

Name: Neo4jMCP
Description: Private tunnel for the Neo4j MCP server

tunnel_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Шаг 9: Стварыць ключ API для часу выканання

Для шага 9: Стварыць ключ API для часу выканання, перш чым зменіць код, неабяжна візначыць параметры входу, адміністратара шага і крытэрыя завершэння. Аператары должны магчымаць перзапуск шага з вядомай точкі контролю без неабяжнага вычыслення схованых станоў. Спрыяйце цім этапу як кантракту межа параметрамі входу і перакананымі рэзультатамі. Дайце назву файлам, візначыце перакананні на успех і адмовіцеся ад тыхняга частковага завершэння без паведамлення. Працавайце з прыкладамі пасёлка пасля першага пакета. З’явы Cypher выкрываюць зміны атрыбутаў і ўтрату власнасцей дышэўней, чым тэсты чату з початку да канца.

export CONTROL_PLANE_API_KEY="sk-YOUR_RUNTIME_KEY"

Шаг 10: Наладзіце tunnel-client для запуску Neo4j MCP

Для 10-го крока: ў налаштаваннях tunnel-client, які запускаюць Neo4j MCP, неабяжна пазначыць параметры вводу, адпаведальнага за крок і крытэрыі завершэння пры змяне коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не прабуючы спадарожваць скрыты стан. Запісвайце час выканання і вартасць токена або запытку разам з функцыйнальнымі рэзултатамі. Відразы вартасці з самага пачатку запобегае неспакоўным рахункам, калі працэс пераходзіць з дэмовай асяроддзя ў спакульную. Пасля першага пакета дадзеных перагледзіце прыкладны район. Інструменты Cypher дапамагаюць выявіць змены ў атрыбутах і відсутнае значэнняя прызначэнняў дэшча, чым тэсты праз чат з початку і до канца.

export CONTROL_PLANE_API_KEY="sk-YOUR_RUNTIME_KEY"
export NEO4J_URI="bolt://127.0.0.1:7687"
export NEO4J_USERNAME="mcp_reader"
export NEO4J_PASSWORD="YOUR_NEO4J_PASSWORD"
export NEO4J_DATABASE="neo4j"
export NEO4J_READ_ONLY="true"
export NEO4J_TRANSPORT_MODE="stdio"

tunnel-client init \
  --sample sample_mcp_stdio_local \
  --profile neo4j-local \
  --tunnel-id "tunnel_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  --mcp-command "/usr/local/bin/neo4j-mcp"

tunnel-client doctor \
  --profile neo4j-local \
  --explain

tunnel-client run --profile neo4j-local

11-й крок: Пераканацца ў супяўзе з мерыжай Ubuntu

Для крока 11: Абы пераканаліць з’яўленне сеткавага з’язку Ubuntu, перад змянай коду неабходна задаць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння. Аперацыёныя працавнікі павінны магчымае перазапускаць крок з вядомай точкі контролю, не спрабоўваючы здогадвацца пра схованы стан. Конфігурацыю трэба залічыць праза код аплікацыі. Файлы серавэра, хранільнікі секрэтных дадзеных і флагі функцыйяў павінны знаходзіцца ў аднам месцы, якое працавнікі можуць аўдытаваць, не чытаючы весь граф. Пасля першай партыі трэба адразу перагледзець прыкладны раён. Засобы Cypher дапамагаюць выявіць змены атрыбутаў і відсутнае значэнняя прыналежнасцей дэшава, чым тэсты чату з початку да канца. Для крока 11: Абы пераканаліць з’яўленне сеткавага з’язку Ubuntu, перад змянай коду неабходна задаць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння. Аперацыёныя працавнікі павінны магчымае перазапускаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы, чым велікія скрыпты. Калі крок не выйшаў, прычына неудачы павінна вказваць на адзін конкрэтны элемент, які трэба практычнаць.

здольнасць, а не заплутаны лянцюг працы.

curl -I https://api.openai.com

Шаг 12: Стварыць дапрыгу для рэжыма распрацоўшчыка ChatGPT

Для шага 12: Стварыць дапрыгу для рэжыма распрацоўшчыка ChatGPT, перш чым зменіць код, неабяжна візначыць даныя, адпаведальнага за шаг і крытэрыі завершэння. Аперацыяныя працавнікі должны магчымае перазапускаць шаг з вядомай точкі контролю, не падозрываючы прыхованы стан. Спрыяйце гэтам этапу як кантракту межа данымі і паверыжанымі выходнымі рэзультатамі. Дайце назвы артыфактам, візначыце пераканальнікі успеху і адмовіцеся ад тыхняй частковай працы без паведамлення. Стварыце вузлы і зв’язкі для запітанняў, якія вы будзеце ставіць, а не для кожнага іменніка ў дакуменце. Рэдкія, тыпаваныя рэбры працуюць лепшая чым ўжоўтканыя, загадковыя графы.

Шаг 13: Паверыжваць інтэграцыю

Для 13-го крока: пераканаліцаваеце інтэграцыю, задайце вхідныя даны, адміністратара крока і крэтырыя для завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымаць перапрыявленне крока з вядомай точкі контролю без адгадвання захаванага стану. Запісваеце час выканання і кост токена або запыту праз ці функцыйнальныя рэзултаты. Відразлівая відомасць коста з’яўляецца запобежненням неспакою праз непрыявленыя рахункі, калі траекторыя пераходзіць з дэмавайнага сераўера у спадзеленыя сераўеры. Ствараеце вузлі і зв’язкі для запытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Разрозненыя, тыпаваныя рэбры лепшыя за ўжоўтучныя, загадковыя графы.

Чэк-ліст для аперацый

Для чэк-ліста для аперацый задайце вхідныя даны, адміністратара крока і крэтырыя для завершэння пры зміне коду. Аперацыйныя працавнікі должны магчымаць перапрыявленне крока з вядомай точкі контролю без адгадвання захаванага стану.

Запісвайце адно і шлях успеху, і шлях вярнення. Перапрыбуткі, людзкія контраліны і обработка некорэктных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней.

Працавайце з прыкладамі раёнаў пасля першай партыі. Засобы тыпу Cypher probes выявляюць змены атрыбутаў і ўтрату характэрыстыкаў дарожэй, чым тэсты чату з початку да канца.

Адкройце інструменты з вузкімі схемамі і чыткімі пазначэннямі парадуктываў. Хостам неабходна ведаць, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць ўпрацоўкі.

Калі дозволяе бюджэт, дадаце тэсты тыпу smoke test, якія перабіраюць крытычны шлях у сістэме CI з вікорыстаннем фіксатываў, а не рэальных платных API.

Запісвайце часы выканання і кост токенаў або запытаў разам з функцыйнальнымі рэзултатамі. Відразувая відомасць костаў запобегае неспакойным рахункам, калі шлях пераходзіць з дэмаверсіі ў спакульнаныя сераўсы.

Перш чым запускаць даную структуру, заморозьце версіі, зафіксавце „золаты” транскрыпты для крытычных элементаў і паказвце способы вярнення да пачатковага стану. У спільных срэдах неабходны ліміты швайнаў, перакананні ў правах на вікорыстоўванне рэсурсаў і чысткі власнік для змены секрэтных даных. Валіце простую надзейнасць працы над крэатывнымі, але разовымі дэманстрацыямі.