Ajvkrish Art MCP

MCPAI代理

提供方 ajvkrish-art

AI代理 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

一个使用DynamoDB存储和检索用户信息及上下文,提供个性化问答功能的MCP服务器。

一句话选型结论

按资料字段整理

Ajvkrish Art MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 4 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量4暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

问答系统TypeScript本地部署上下文管理用户认证DynamoDB集成个性化服务

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
docker run -p 3000:3000 --env-file .env mcp-dynamodb-server

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Docker,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 4 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 4 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ajvkrish Art MCP当前 4 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ajvkrish-art上游标注的维护方 ajvkrish-art
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Docker本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.3 KB
来自项目仓库与上游目录的原文,未做删改

MCP Server with DynamoDB Integration

A Model Context Protocol (MCP) server that uses DynamoDB to store and retrieve user information and context to provide personalized question answering capabilities.

🚀 Features

  • User Authentication: JWT-based authentication with registration and login
  • Context Management: Store and retrieve user conversation history and context
  • Question Answering: Context-aware Q&A with user-specific responses
  • MCP Protocol: Full Model Context Protocol implementation
  • DynamoDB Integration: Scalable NoSQL database for user data
  • Security: Rate limiting, CORS, input validation, and secure password handling
  • Logging: Comprehensive logging with Winston
  • TypeScript: Full TypeScript support with strict typing

📋 Prerequisites

  • Node.js 18+
  • AWS Account with DynamoDB access
  • AWS CLI configured (optional, for local development)

🛠️ Installation

  1. Clone the repositorybash git clone <repository-url> cd mcp-dynamodb-server

  2. Install dependenciesbash npm install

  3. Set up environment variablesbash cp env.example .env

Edit .env with your configuration:```env
# Server Configuration
PORT=3000
NODE_ENV=development

# JWT Configuration
JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
JWT_EXPIRES_IN=24h
JWT_REFRESH_EXPIRES_IN=7d

# AWS Configuration
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key

# DynamoDB Configuration
DYNAMODB_ENDPOINT=http://localhost:8000 # Use AWS endpoint for production
DYNAMODB_TABLES_USERS=users
DYNAMODB_TABLES_USER_CONTEXTS=user_contexts
DYNAMODB_TABLES_QUESTIONS_ANSWERS=questions_answers
```

  1. Set up DynamoDB tablesbash npm run setup-db

  2. Build the projectbash npm run build

  3. Start the server```bash
    # Development mode
    npm run dev

# Production mode
npm start
```

🏗️ Project Structure```

mcp-dynamodb-server/
├── src/
│ ├── server/
│ │ ├── mcp-server.ts # Main MCP server implementation
│ │ ├── handlers/
│ │ │ ├── auth-handler.ts # Authentication endpoints
│ │ │ ├── context-handler.ts # Context management
│ │ │ └── qa-handler.ts # Question answering
│ │ └── middleware/
│ │ ├── auth-middleware.ts # JWT authentication
│ │ └── logging.ts # Request logging
│ ├── database/
│ │ ├── dynamodb-client.ts # DynamoDB connection and operations
│ │ └── models/
│ │ └── user.ts # User data model
│ ├── utils/
│ │ ├── config.ts # Configuration management
│ │ └── logger.ts # Logging utilities
│ └── types/
│ └── mcp-types.ts # TypeScript type definitions
├── scripts/
│ └── setup-dynamodb.js # DynamoDB table creation
├── package.json
├── tsconfig.json
└── README.md


## 🔧 Configuration

### Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `PORT` | Server port | `3000` |
| `NODE_ENV` | Environment | `development` |
| `JWT_SECRET` | JWT signing secret | Required |
| `JWT_EXPIRES_IN` | Access token expiry | `24h` |
| `JWT_REFRESH_EXPIRES_IN` | Refresh token expiry | `7d` |
| `AWS_REGION` | AWS region | `us-east-1` |
| `AWS_ACCESS_KEY_ID` | AWS access key | Required |
| `AWS_SECRET_ACCESS_KEY` | AWS secret key | Required |
| `DYNAMODB_ENDPOINT` | DynamoDB endpoint | `http://localhost:8000` |

### DynamoDB Tables

The server creates three DynamoDB tables:

1. **users** - User profiles and authentication data
2. **user_contexts** - User conversation history and context
3. **questions_answers** - Q&A pairs and responses

## 📚 API Documentation

### Authentication Endpoints

#### Register User```http
POST /api/auth/register
Content-Type: application/json

{
  "email": "user@example.com",
  "username": "username",
  "password": "password123",
  "firstName": "John",
  "lastName": "Doe"
}

Login```http

POST /api/auth/login
Content-Type: application/json

{
"email": "user@example.com",
"password": "password123"
}


#### Refresh Token```http
POST /api/auth/refresh
Content-Type: application/json

{
  "refreshToken": "your-refresh-token"
}

Context Management

Create Context```http

POST /api/context
Authorization: Bearer <access-token>
Content-Type: application/json

{
"content": "User conversation context",
"source": "chat",
"tags": ["conversation", "support"],
"relevance": 0.8
}


#### Get User Context```http
GET /api/context/:userId?limit=10&amp;offset=0
Authorization: Bearer &lt;access-token&gt;

Update Context```http

PUT /api/context/:userId/:contextId
Authorization: Bearer <access-token>
Content-Type: application/json

{
"content": "Updated context content",
"relevance": 0.9
}


### Question Answering

#### Ask Question```http
POST /api/qa/ask
Authorization: Bearer &lt;access-token&gt;
Content-Type: application/json

{
  &quot;question&quot;: &quot;What is the status of my order?&quot;,
  &quot;useContext&quot;: true,
  &quot;contextLimit&quot;: 10,
  &quot;category&quot;: &quot;support&quot;,
  &quot;priority&quot;: 3,
  &quot;tags&quot;: [&quot;order&quot;, &quot;status&quot;]
}

Get Q&A History```http

GET /api/qa/history/:userId?limit=20&offset=0
Authorization: Bearer <access-token>


### MCP Protocol

The server implements the Model Context Protocol and exposes tools:

- `get_user_context` - Retrieve user context and conversation history
- `store_user_context` - Store new user context or conversation
- `answer_question` - Answer a question using user context
- `get_user_profile` - Get user profile information

## 🔒 Security Features

- **JWT Authentication**: Secure token-based authentication
- **Password Hashing**: bcrypt for password security
- **Rate Limiting**: Request rate limiting per IP and user
- **Input Validation**: Joi schema validation for all inputs
- **CORS Protection**: Configurable CORS settings
- **Helmet**: Security headers middleware
- **Request Logging**: Comprehensive request/response logging

## 🧪 Testing```bash
# Run tests
npm test

# Run tests with coverage
npm run test:coverage

# Run tests in watch mode
npm run test:watch

📝 Logging

The server uses Winston for logging with the following levels:
- Error: Application errors and exceptions
- Warn: Warning messages
- Info: General information and requests
- Debug: Detailed debugging information

Logs are written to:
- Console (development)
- logs/app.log (all levels)
- logs/error.log (error level only)

🚀 Deployment

Docker Deployment

  1. Build Docker imagebash docker build -t mcp-dynamodb-server .

  2. Run containerbash docker run -p 3000:3000 --env-file .env mcp-dynamodb-server

AWS Deployment

  1. Set up AWS credentials
  2. Create DynamoDB tables
  3. Deploy to ECS or Lambda
  4. Configure environment variables

🔧 Development

Available Scripts```bash

npm run build # Build TypeScript
npm run dev # Start development server
npm run start # Start production server
npm run test # Run tests
npm run lint # Run ESLint
npm run lint:fix # Fix ESLint issues
npm run format # Format code with Prettier
npm run setup-db # Set up DynamoDB tables
```

Code Quality

  • TypeScript: Strict type checking
  • ESLint: Code linting and style enforcement
  • Prettier: Code formatting
  • Jest: Unit and integration testing

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Run the test suite
  6. Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

For support and questions:
- Create an issue in the repository
- Check the documentation
- Review the API examples

🔮 Roadmap

  • [ ] AI service integration (OpenAI, Anthropic)
  • [ ] Context summarization and optimization
  • [ ] Real-time notifications
  • [ ] Advanced analytics and metrics
  • [ ] Multi-tenant support
  • [ ] GraphQL API
  • [ ] WebSocket support for real-time features

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Ajvkrish Art MCP 怎么安装?

在客户端按下面的安装命令接入:docker run -p 3000:3000 --env-file .env mcp-dynamodb-server。装完在客户端配置里引用同一个包或端点。

Ajvkrish Art MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Ajvkrish Art MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ajvkrish Art MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Ajvkrish Art MCP 能提供哪些能力?

资料显示约 4 个工具;能力标签包括 问答系统、TypeScript、上下文管理。具体工具清单以官方文档为准。

Ajvkrish Art MCP 需要什么运行环境?

运行时为 Docker;属于本地进程,需要在本机装好运行环境。

Ajvkrish Art MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。