Skip to content

Commit 84aa3a3

Browse files
authored
Merge pull request #378 from antalike/v2/content
fix: update title
2 parents e64bb7b + b0649cf commit 84aa3a3

File tree

4 files changed

+29
-13
lines changed

4 files changed

+29
-13
lines changed

content/cn/open_source/best_practice/mcp_for_cozespace_and_tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: MemOS MCP集成指南
2+
title: Coze空间配置Memos的MCP
33
description: 在Coze等平台配置MemOS的MCP服务,实现智能体与记忆系统的无缝集成
44
---
55

content/cn/open_source/best_practice/network_workarounds.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: 网络问题解决方案
2+
title: 网络环境适配
33
desc: 以下是一些在开发过程中可能遇到的网络问题的应对方案。
44
---
55

content/en/open_source/best_practice/mcp_for_cozespace_and_tools.md

Lines changed: 18 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: MemOS MCP Integration Guide
3-
description: Configure MemOS MCP service on platforms like Coze to seamlessly integrate agents with the memory system
2+
title: Configuring Memos MCP in Coze Space
3+
description: Configure MemOS MCP service on platforms like Coze to achieve seamless integration between agents and memory systems
44
---
55

66
This guide helps you configure MemOS MCP service in platforms like Coze Space, enabling seamless integration between your agent and the memory system.
@@ -14,6 +14,7 @@ MemOS provides two MCP deployment options. Choose based on your needs:
1414
If you want to connect quickly without deploying your own server, MemOS official cloud service is recommended.
1515

1616
**Advantages:**
17+
1718
- ✅ Out of the box, no deployment required
1819
- ✅ High availability guarantees
1920
- ✅ Automatic scaling and maintenance
@@ -24,6 +25,7 @@ If you want to connect quickly without deploying your own server, MemOS official
2425
Visit [MemOS Cloud MCP Configuration Guide](https://memos-docs.openmem.net/cn/mcp_agent/mcp/guide) for detailed instructions.
2526

2627
Main steps:
28+
2729
1. Register and get an API Key in [MemOS API Console](https://memos-dashboard.openmem.net/cn/apikeys/)
2830
2. Configure `@memtensor/memos-api-mcp` service in your MCP client
2931
3. Set environment variables (`MEMOS_API_KEY`, `MEMOS_USER_ID`, `MEMOS_CHANNEL`)
@@ -33,12 +35,14 @@ Main steps:
3335
If you need a private deployment or custom requirements, you can deploy MCP service on your own server.
3436

3537
**Advantages:**
38+
3639
- ✅ Fully private data
3740
- ✅ Configurable and customizable
3841
- ✅ Full control of the service
3942
- ✅ Suitable for internal enterprise use
4043

4144
**Prerequisites:**
45+
4246
- Python 3.9+
4347
- Neo4j database (or another supported graph database)
4448
- HTTPS domain (required by platforms like Coze)
@@ -66,6 +70,7 @@ MemOS Core Service
6670
```
6771

6872
**Component overview:**
73+
6974
- **Server API**: provides REST APIs (`/product/*`) to handle memory CRUD
7075
- **MCP Server**: exposes the MCP protocol over HTTP and calls Server API to complete operations
7176
- **HTTPS reverse proxy**: platforms like Coze require HTTPS secure connections
@@ -124,6 +129,7 @@ export MEMOS_API_BASE_URL="http://localhost:8001/product"
124129
::note
125130
**Tool list**<br>
126131
MCP service provides the following tools:
132+
127133
- `add_memory`: add memory
128134
- `search_memories`: search memories
129135
- `chat`: chat with the memory system
@@ -222,6 +228,7 @@ https://your-domain.com/mcp
222228
```
223229

224230
Available MCP tools:
231+
225232
- **add_memory**: add a new memory
226233
- **search_memories**: search existing memories
227234
- **chat**: memory-based chat
@@ -249,6 +256,7 @@ python src/memos/api/server_api.py --port 8001
249256
```
250257

251258
**Port notes**
259+
252260
- Server API runs on port 8001 by default
253261
- Provides `/product/*` REST API endpoints
254262

@@ -338,10 +346,10 @@ After publishing, you can view the plugin under "My Resources":
338346
### Step 5: Integrate into agent workflow
339347

340348
Add the plugin into the agent workflow:
341-
342349
1. Create a new agent or edit an existing agent
343350
2. Add the published MemOS plugin to the tool list
344351
3. Configure the workflow to call memory tools
352+
345353
4. Test memory write and retrieval functions
346354

347355
::
@@ -355,6 +363,7 @@ Add the plugin into the agent workflow:
355363
**Solution:**
356364
- Check whether Server API is running: `curl http://localhost:8001/docs`
357365
- Check whether environment variable `MEMOS_API_BASE_URL` is configured correctly
366+
358367
- Check MCP service logs and confirm the call address
359368

360369
### Q2: Coze cannot connect to MCP service
@@ -363,20 +372,23 @@ Add the plugin into the agent workflow:
363372
- Make sure you use HTTPS
364373
- Check whether the SSL certificate is valid
365374
- Test reverse proxy configuration: `curl https://your-domain.com/mcp`
375+
366376
- Check firewall and security group settings
367377

368378
### Q3: Neo4j connection failed
369379

370380
**Solution:**
371381
- Ensure Neo4j service is running
372382
- Check connection info in the configuration file (uri, user, password)
383+
373384
- Refer to `examples/data/config/tree_config_shared_database.json` as an example configuration
374385

375386
### Q4: How to see complete API examples?
376387

377388
**Reference files:**
378389
- MCP server: `examples/mem_mcp/simple_fastmcp_serve.py`
379390
- MCP client: `examples/mem_mcp/simple_fastmcp_client.py`
391+
380392
- API tests: `examples/api/server_router_api.py`
381393

382394
---
@@ -387,6 +399,7 @@ With this guide, you can:
387399
- ✅ Choose a suitable MCP deployment option (cloud or self-hosted)
388400
- ✅ Complete the full MCP service deployment process
389401
- ✅ Integrate MemOS memory features into platforms like Coze
402+
390403
- ✅ Integrate directly via REST API
391404

392405
No matter which option you choose, MemOS can provide your agent with powerful memory managementders=headers, data=payload)
@@ -398,6 +411,7 @@ No matter which option you choose, MemOS can provide your agent with powerful me
398411
- `messages`: replaces the previous `memory_content`, supports string or message array
399412
- `writable_cube_ids`: replaces the previous `mem_cube_id`, supports multiple cubes
400413
- Server API runs on port 8001, and the path is `/product/add`
414+
401415
- Ensure it matches MemOS Server API interface. You can refer to the example in `examples/api/server_router_api.py`
402416
**IDE configuration**<br>In the IDE, you can customize tool parameters, return value formats, etc., ensuring consistency with MemOS API. Use this method to implement the search endpoint and user registration endpoint, then click Publish.
403417
::
@@ -411,11 +425,8 @@ After publishing, you can view the plugin under "My Resources" and integrate it
411425
### Build an Agent and Test
412426

413427
After building the simplest agent, you can test memory operations:
414-
415428
1. Create a new agent
416429
2. Add the published memory plugin
417430
3. Configure the workflow
418-
4. Test memory write and retrieval functions
419-
420-
With the above configuration, you can successfully integrate MemOS memory features in Coze Space and provide powerful memory capabilities for your agent.
421431

432+
4. Test memory write and retrieval functions

content/en/open_source/best_practice/network_workarounds.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: Network Workarounds
3-
desc: Here are some solutions to address the network issues you may encounter during developing.
2+
title: Network Environment Adaptation
3+
desc: The following are some solutions to network issues that may be encountered during development.
44
---
55

66
## **Downloading Huggingface Models**
@@ -42,6 +42,7 @@ Use huggingface-cli to download models or datasets. For example:
4242
For more detailed instructions and additional methods, please refer to [this link](https://hf-mirror.com/).
4343

4444
### Alternative Sources
45+
4546
You may still encounter limitations accessing some models in your regions. In such cases, you can use modelscope:
4647

4748
::steps{level="4"}
@@ -62,6 +63,7 @@ Use modelscope to download models or datasets. For example:
6263
```bash
6364
modelscope download --model 'Qwen/Qwen2-7b' --local_dir 'path/to/dir'
6465
```
66+
6567
- To download a dataset:
6668

6769
```bash
@@ -75,6 +77,7 @@ For more detailed instructions and additional methods, please refer to the [offi
7577
## **Using Poetry**
7678

7779
### Network Errors during Installing
80+
7881
To address network errors when using "poetry install" in your regions, you can follow these steps:
7982

8083
::steps{level="4"}
@@ -98,10 +101,12 @@ Run the command `poetry lock` in the terminal to reconfigure Poetry with the new
98101

99102
**Tips:**
100103
Be aware that `poetry lock` will modify both Pyproject.toml and poetry.lock files. To avoid committing redundant changes:
101-
- Option 1: After successful `poetry install`, revert to the git HEAD node using `git reset --hard HEAD`.
102-
- Option 2: When executing `git add`, exclude the Pyproject.toml and poetry.lock files by specifying other files.
104+
105+
- Option 1: After successful `poetry install`, revert to the git HEAD node using `git reset --hard HEAD`.
106+
- Option 2: When executing `git add`, exclude the Pyproject.toml and poetry.lock files by specifying other files.
103107

104108
For future dependency management tasks like adding or removing packages, you can use the `poetry add` command:
109+
105110
```bash
106111
poetry add <lib_name>
107112
```

0 commit comments

Comments
 (0)